A yabai or AeroSpace status bar widget for Übersicht inspired by nibar, yabar and this reddit post.

Website • Documentation

simple-bar-server is available to trigger refresh and toggle widgets more efficiently with curl commands.

A more "lite" & basic version is available here.

Notice: As I am working simultaneously on a lot of projects, things here may seem to move slowly but they are still in progress. I'm always monitoring my notifications and messages, so if you have any questions or want to chat about anything, feel free to reach out!

Features

Among the principal features of simple-bar, you'll find:

• Show all opened apps in every space
• Show all opened windows on the current space and its current layout mode (bsp, stack, float)
• Interactions: focus window on click, launch scripts, toggle states
• Multi-monitor support: enable individual widget on specific displays
• Add your own custom widgets in settings (it displays scripts outputs)
• Refresh and toggle parts of simple-bar on the fly with curl commands by installing simple-bar-server and enabling the server in settings. See widgets, yabai or AeroSpace options in its documentation
• Extensible themes system with 3 theme behaviors: dark, light, or system
• Numerous customization options, try them out in settings!
• A handfull selection of widgets
• Other features available only with SIP disabled and yabai scripting addition installed (navigate to workspace, create new workspace on "+" click, move or destroy workspace on space hover)

See all features in documentation.

Preview

simple-bar-demo.mp4

Installation

Simply clone this repo in your Übersicht widgets directory with the following command.

git clone --depth 1 https://github.com/Jean-Tinland/simple-bar $HOME/Library/Application\ Support/Übersicht/widgets/simple-bar

You'll find the full installation guide in the documentation.

Warning

If you encounter this error: "simple-bar-index.jsx: Something went wrong…", it may be simply due to the fact that the default value for yabai or AeroSpace path is wrong in simple-bar. You can set this path in the settings module.
The default paths are $(which yabai) and $(which aerospace).

Note

simple-bar is trying to use yabai by default. If you want to switch to AeroSpace, you'll need to open the settings module (simply click on simple-bar then press cmd + ,). You'll find the window manager choice in the "Global" tab.

Tip

If you experience some freezing issues with Übersicht or if you simply want to improve simple-bar responsiveness & energy consumption, please try to switch to simple-bar-server in order to trigger refresh with curl commands. You'll find more information about it in the repo here.

Roadmap

Here are the features I'm planning to add in the future:

• A timer widget (#474)
• Bars configurator (spawn multiple bars, place widgets anywhere…) #380
• More accessibility settings like reading direction (LTR or RTL)
• More default themes

Feel free to open an issue if you have any feature request or if you want me to prioritize one of these features.

Special thanks

I started this project with a simple idea and inspired by similar projects but over the year it has become a real community project. I want to thank everyone who contributed to this project, whether it's by opening issues, suggesting features, or even making pull requests. Furthermore, I also want to thank everyone who is using this project, I'm glad to see that it can be useful to others.

So thank you, @Amar1729, @yorhodes, @ZhongXiLu, @jamieweavis, @kvndrsslr, @rosenpin, @MikoMagni, @anujc4, @SijanC147, @donaldguy, @d-miketa, @izifortune, @theshortcut, @jming422, @s00500, @spwx, @basbebe, @is0n, @Joroovb, @Sylenss, @mrzone64, @devinbhatt, @mdwitr0, @wr1159, @ardnep, @kntng and every other that are helping me improve this little project by adding icons, fixing what they can, and more…

I tried to keep track of everyone who contributed to this project in every page of the documentation. If you think I forgot you, please let me know. :)