2021-08-14 00:21:10 +00:00
# SketchyBar
This is a rewrite of the spacebar project, which itself is a rewrite of the statusbar code from yabai.
What I have added:
* As many widgets as you like at any of the three positions: left, center, right
* The order of the widgets in the sketchybarrc file will be the order in which they show in the bar
* Associate widgets to certain displays or spaces, to show specific information on the relevant screens/displays
* The widgets are highly customizable with settings for different fonts, colors, icon paddings, label paddings, etc. for each individual element
* Relocate *all* visible components of the bar (even spaces or the window title, etc.)
* Draw arbitrary graphs in the bar with external data provider scripts that push the data into the graph
* Overlay as many graphs as wanted, like system cpu usage and user cpu usage in one figure
* Individual refresh frequencies for each widget
2021-08-14 19:33:27 +00:00
* Let items subscribe to system events (e.g. space changed, window focused, etc.) for their refresh action (like in yabai)
2021-08-17 00:15:12 +00:00
* "click" events for the widgets, where a script can be specified to run on a mouse click
2021-08-14 00:21:10 +00:00
* ... feel free to explore my sketchybarrc file for more details on the options
2021-08-14 11:29:00 +00:00
I have many more plans for the project:
2021-08-14 19:54:43 +00:00
* ~~Let items subscribe to system events (e.g. space changed, window focused, etc.) for their refresh action (like in yabai)~~ (DONE)
2021-08-14 11:29:00 +00:00
* Cache the scripts in RAM to reduce I/O operations
2021-08-14 19:54:43 +00:00
* ~~Make the associated_space / associated_display properties more powerful by allowing to associate to more than one screen/display~~ (DONE)
2021-08-14 11:29:00 +00:00
* Make application specific widgets with associated_app argument (e.g. when gvim is open show the vim mode indicator in the status bar)
* Fix the currently static positioning of the bar
* A y_offset property for all items to create (in combination with the nospace modifier) vertically stacked labels
* Create more plugins
* ......
2021-08-14 00:21:10 +00:00
This is my setup:
where I have my screens and a vim mode indicator on the left. Not shown is the high memory warning which shows the process that is using high system memory on demand.
In the center I have a spotify indicator (only when music is playing) and on the right I have (not shown) a high cpu process indicator, as well as a cpu graph, a github contribution counter, a new mail counter and the current date.
The cpu and memory indicators are only shown on the "code" screen and are not visible on the other screens.
## Installation
2021-08-14 20:38:55 +00:00
Clone the repo and in it run
2021-08-14 00:21:10 +00:00
```bash
2021-08-14 20:42:59 +00:00
make install
2021-08-14 00:21:10 +00:00
```
2021-08-14 20:38:55 +00:00
This installs the app with my configuration preinstalled.
You can customize the configuration inside of $HOME/.config/sketchybar/sketchybarrc
and run the bar via
2021-08-14 00:21:10 +00:00
```bash
sketchybar
```
2021-08-14 20:38:55 +00:00
If you want to use your own plugins, make sure that they are referenced in the rc with the correct path and that they are made executable via
2021-08-14 11:29:00 +00:00
```bash
chmod +x name/of/plugin.sh
```
You should of course vet the code from all plugins before granting them the executable bit to make sure they are not harming your computer.
2021-08-14 00:21:10 +00:00
2021-08-14 20:58:01 +00:00
If you have problems with missing fonts you might need to install the Hack Nerd Font:
```bash
brew tap homebrew/cask-fonts
brew install --cask font-hack-nerd-font
```
2021-08-13 14:30:44 +00:00
Credits:
yabai,
spacebar,
reddit,
2021-08-14 00:21:10 +00:00
many more for the great code base and inspiration
