Installation
Prerequisites
In order to make this simple-bar work, you'll need to install both yabai and Übersicht, both of them must be up to date. simple-bar
supports yabai from v3 to v6 (v6 is mandatory on Sonoma). They both need to be up and running.
Be careful, for Big Sur users (and above), some actions must be taken in order to make yabai fully operational: see explanations here in yabai github repo.
It is important to note that you'll need to use yabai in
bsp
orstack
layout mode in order to prevent app windows to overlap simple-bar.
Installation procedure
Clone this repo to your Übersicht widgets directory with the following command.
bash$ git clone https://github.com/Jean-Tinland/simple-bar $HOME/Library/Application\ Support/Übersicht/widgets/simple-bar
Be careful, the folder containing the widget must be named simple-bar
, otherwise, simple-bar will never launch.
After cloning the project, simply activate simple-bar widget in Übersicht's widgets list: simple-bar-index-jsx
.
On the first simple-bar
execution, an alert should pop on your screen saying that Übersicht want access your browser control (only the first time you launch your favorite browser with simple-bar
opened). It is required to agree to this in order to make the BrowserTrack
widget work.
For users having the latest M1 and M2 mac variants, yabai is installed by default in /opt/homebrew/bin/yabai
. You can set this path in the settings module allowing a custom yabai path. Same if you have installed yabai in a custom path for any reason.
JetBrains Mono is used by default. You can set your own font in the "Global" settings tab.
Update your yabai
config
In order to prevent simple-bar freezing upon yabai restart, you'll need to add this line at the start of your .yabairc
file:
shellosascript -e 'tell application id "tracesOf.Uebersicht" to refresh'
This will enable a full refresh of simple-bar
on each yabai
restart thus allowing it to re-enable it signals.
Compatibility & testing
simple-bar
has only been tested on several Intel & Apple Silicon based Macs and is working on Catalina, Big Sur & above...
You'll need a screen with a size of 13" at least with your screen resolution scaled on "More space" setting.
simple-bar
will work on smaller screens but you'll need to make a choice between the widgets you want to display.
simple-bar
is optimized for the english language. Icon association is not localized and some minor features may not work as expected.