Repository files navigation

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 apolybar/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 withdefault 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:

• 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...

• 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

• InstallPython 3.10
• Install required Python Modules:
  • pip install -rrequirements.txt
• Create the directoryC:/Users/{username}/.yasb/ and copystyles.css andconfig.yaml into folder.
  • Configurestyles.css andconfig.yaml to your liking.
• Start the application:
  • runpython 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 anissue 🐛

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 fileconfig.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 stylesheetstyles.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 runningkomorebi 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 thesubprocess module. For this to work, you MUST havekomoreb.exe andkomorebic.exeadded 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 usingpylama:

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

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

• Commit messages should ideally follow theConventional Commits specification.
• Pull Requests should be submittedhere