A highly configurable cross-platform (Windows) status bar written in Python.
Yasb (Yet Another Status Bar) is a highly configurable status bar written in Python using the Qt6 GUI Framework. The current goal of yasb is to bring a polybar/waybar-style status bar to the Windows platform. However, as yasb is written in Python + Qt6, it is cross-platform capable. With some minor adjustments and OS-specific widgets, yasb can also be configured to run on both Linux and Mac OSX.
Although yasb comes with default stylesheet and configuration files, the user is given complete control over how their status bar is structured and how it will look.
The config file allows for extensive configuration of one or more taskbars, whereas, the stylesheet used by yasb allows for complete control over how the bar and its nested widgets should look. Change everything from font and colours to rounded corners, padding and opacity.
For an example of the default bar configuration, see the image below:
C:/Users/{username}/.yasb/
and copy styles.css and config.yaml into folder.
python src/main.py
in your terminal (or create a startup shortcut)This project is still in early development... If you encounter any bugs, please submit an issue :bug:
Note: Please include a log file along with steps to reproduce when submitting a bug report, it helps!
All taskbars can be configured in a user-defined YAML config file config.yaml located in either of the following directories:
C:/Users/{username}/.yasb/config.yaml
/path/to/yasb/src/config.yaml
All taskbars can also be styled using a configurable stylesheet styles.css:
C:/Users/{username}/.yasb/styles.css
/path/to/yasb/src/styles.css
NOTE: If either configuration file is not present in the user's $HOME/.yasb
directory (or if they contain errors), the default config and stylesheet will be loaded instead. You may also be prompted with a popup error dialog showing which lines of code contain linting errors.
By default, yasb uses the Font Awesome 5 Free icon font. If this is not installed on your system, this is likely the reason why icons are not appearing correctly in your taskbar.
If you would like to use a different icon font, simply change the wildcard font-family CSS rule in the stylesheet file to your prefered icon font:
* {
font-family: 'Courier New', 'Font Awesome 5 Free';
font-size: 16px;
...
}
The Komorebi Workspace widget bundled with Yasb requires that you are running komorebi v0.18.0 or above. This is because previous komorebi versions do not support socket-based communication with external applications via Windows Named Pipes. If you are running an older version of komorebi, yasb will not be able to query komorebi for workspace information.
Note: Yasb executes komorebic.exe commands directly via the subprocess module. For this to work, you MUST have komoreb.exe
and komorebic.exe
added to your system PATH.
Contributions to yasb are more than welcome. This project was started as an experiment and has blossomed into something I use every day. If you find good use out of this software but believe there are areas for improvement (of which there are likely many), please feel free to submit a Pull Request.
All you will need to get started is Python 3.9 or above.
The project is linted using pylama:
pip install pylama
python -m pylama
# or just run 'pylama'