Skip to content

Jean-Tinland/simple-bar

Repository files navigation

simple-bar

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

WebsiteDocumentation

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

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

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 widgets on the fly with curl commands by installing simple-bar-server and enabling the server in settings
  • Refresh spaces & processes on the fly with curl commands by installing simple-bar-server and enabling the right signales in your .yabairc(way faster than Übersicht refresh triggered by applescript)
  • 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

image

simple-bar-demo.mp4

Installation

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

git clone 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.

Note

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.

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.

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. 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. :)