README.md

Yasb - Yet Another Status Bar

A highly configurable cross-platform (Windows) status bar written in Python.

What is it?

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.

What can it look like?

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:

Some interesting features:

• Multi-monitor and monitor-exclusive taskbars
• Multiple bars per monitor
• Top, bottom and centred bar alignment
• Full UI customisation via user-defined stylesheet
• Extensive configuration via a user-defined configuration file
• Config and stylesheet validation
• Configurable taskbar widgets
  • Active Window Title (and other window information)
  • Battery Widget with customisable
  • Clock Widget with multi-time zone support
  • Custom (command line) Widgets with JSON parsing
  • Memory & CPU Monitor Widgets
  • Komorebi WM Workspace Widget
  • and more...

TODO List

• Documentation (Wiki is WIP)
• Automatic bar creation/deletion for screen connect/disconnect events
• New top, left, bottom, right padding setting
• Config/stylesheet auto-loading (via file watcher)
• Window Blur effect
• SCSS stylesheet support
• Tray options for toggling bars on/off
• Improve default CSS stylesheet
• Media Player Widget - WIP
• Disk Space Widget
• Keyboard State Widget
• Bluetooth(?) Widget
• Volume Widget
• Backlight Widget
• Calendar Pop-up for Clock Widget

How do you run it?

• Install Python 3.10
• Install required Python Modules:
  • pip install -r requirements.txt
• Create the directory C:/Users/{username}/.yasb/ and copy styles.css and config.yaml into folder.
  • Configure styles.css and config.yaml to your liking.
• Start the application:
  • run python src/main.py in your terminal (or create a startup shortcut)

What do I do if I've spotted a bug?

This project is still in early development... If you encounter any bugs, please submit an issue 🐛

Note: Please include a log file along with steps to reproduce when submitting a bug report, it helps!

How do you configure it?

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.

Troubleshooting

Why aren't icons being displayed correctly in my taskbar?

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;
    ...
}

Why is the Komorebi Workspaces widget not working?

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

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.

Development Environment

All you will need to get started is Python 3.9 or above.

Linting

The project is linted using pylama:

pip install pylama
python -m pylama
# or just  run 'pylama'

• The linting tool is configured in pylama.ini
• If you choose to contribute, please lint your code beforehand.

Commit Formatting and Pull Requests

• Commit messages should ideally follow the Conventional Commits specification.
• Pull Requests should be submitted here