SketchyBar

SketchyBar copied to clipboard

Install • Documentation • Setups • Plugins

This bar project aims to create a highly flexible, customizable, fast and powerful status bar replacement for people that like playing with shell scripts.

More Setups

Features

• Optimized to be Fast and Efficient
• Completely Scriptable
• Fully Configurable
• Entirely Animatable
• Support for drawing native macOS menu bar applications (aliases)
• Powerful event and scripting system
• Popup Menus
• Mouse Support
• Support for graphs
• Per display and per space individualization

Getting Started

Refer to the installation guide in the documentation to get the program set up. Once this is sorted you can start to become familiar with the syntax of sketchybar by going through the default sketchybarrc file, which is located in ~/.config/sketchybar/sketchybarrc and looks like this:

All commands and options are explained in detail in the relevant sections of the configuration documentation. You can try the commands directly from the commandline to see which affect they have and how they alter the bar. Once you have become familiar with the syntax you can look for a config to start from here or start from scratch and customize everything to your liking.

You might also enjoy looking at the Tips & Tricks section for some further tips on your journey. If you are searching for functional items you might want to check the plugins section if someone has already created what you are looking for.

Should you encounter things not working as you expect them to, please do not hesitate to open an issue, as this is either a bug or a documentation problem and relevant in any case.

Documentation

For the full documentation of all commands and properties please refer to the website.

If questions remain, feel free to consult the Q&A section.

Supporting

You can support this project is many ways:

• By creating issues and pull-requests if you encounter problems
• By sharing your plugins and setups
• By starring the project on GitHub
• If this project has value to you, consider quantifying it and donating to a charity of your choice. If you want to let me know about your donation, you can contact me via email.

Credits

This project was forked from spacebar and completely reimagined and rewritten.
The original idea is based on the status bar that was included in yabai before getting removed.

Demonstration of the animation system

https://user-images.githubusercontent.com/22680421/173958567-c475eaa2-cd56-45c1-86fc-839d697eaad6.mp4