mirror of
https://github.com/FelixKratz/SketchyBar
synced 2024-11-26 21:30:17 +00:00
87 lines
4.4 KiB
Markdown
87 lines
4.4 KiB
Markdown
<p align="center">
|
|
<img src="images/Sbar.svg" />
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://felixkratz.github.io/SketchyBar/setup">Install</a>
|
|
<span> • </span>
|
|
<a href="https://felixkratz.github.io/SketchyBar/config/bar">Documentation</a>
|
|
<span> • </span>
|
|
<a href="https://github.com/FelixKratz/SketchyBar/discussions/47">Setups</a>
|
|
<span> • </span>
|
|
<a href="https://github.com/FelixKratz/SketchyBar/discussions/12">Plugins</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://opensource.org/licenses/"><img src="https://img.shields.io/badge/License-GPL%20v3-blue.svg"></a>
|
|
<a href="https://github.com/FelixKratz/SketchyBar/releases"><img src="https://img.shields.io/github/v/release/FelixKratz/SketchyBar.svg?style=flat&color=orange" /></a>
|
|
<a href="https://github.com/FelixKratz/SketchyBar/releases"><img src="https://img.shields.io/github/commits-since/FelixKratz/SketchyBar/latest.svg?color=orange"></a>
|
|
<a href="https://en.wikipedia.org/wiki/Free_and_open-source_software"><img src="https://img.shields.io/badge/FOSS-100%25-green.svg?style=flat"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
This bar project aims to create a highly flexible, customizable, fast and powerful status bar replacement for people that like playing with
|
|
shell scripts.
|
|
</p>
|
|
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/FelixKratz/SketchyBar/discussions/47">More Setups</a>
|
|
</p>
|
|
|
|
|
|
|
|
## 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](https://felixkratz.github.io/SketchyBar/setup) 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*](https://github.com/FelixKratz/SketchyBar/blob/master/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](https://felixkratz.github.io/SketchyBar/config/bar). 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](https://github.com/FelixKratz/SketchyBar/discussions/47) or start from scratch and customize
|
|
everything to your liking.
|
|
|
|
You might also enjoy looking at the [Tips & Tricks](https://felixkratz.github.io/SketchyBar/config/tricks) section
|
|
for some further tips on your journey. If you are searching for functional items you might want to check the
|
|
[plugins](https://github.com/FelixKratz/SketchyBar/discussions/12) 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](https://github.com/FelixKratz/SketchyBar/issues), 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](https://felixkratz.github.io/SketchyBar/config/bar).
|
|
|
|
If questions remain, feel free to consult the [Q&A](https://github.com/FelixKratz/SketchyBar/discussions/categories/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](https://github.com/FelixKratz/SketchyBar/discussions/12) and [setups](https://github.com/FelixKratz/SketchyBar/discussions/47)
|
|
- 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](mailto:felix.kratz@tu-dortmund.de?Subject=Donation).
|
|
|
|
## Credits
|
|
This project was forked from *[spacebar](https://github.com/cmacrae/spacebar)* and completely reimagined and rewritten. <br>
|
|
The original idea is based on the status bar that was included in *[yabai](https://github.com/koekeishiya/yabai)* before getting removed.
|
|
|
|
|
|
## Demonstration of the animation system
|
|
|
|
https://user-images.githubusercontent.com/22680421/173958567-c475eaa2-cd56-45c1-86fc-839d697eaad6.mp4
|
|
|