Installation

Requirements

• Nerd Fonts. Install Nerd Fonts (JetBrainsMono recommended)
• Windows 10 & 11

Installer

• Visit the releases page.
• Look for the latest release version, which will typically be listed at the top.
• Under the "Assets" section of the release, youll find various files. Click on the installer file to download it.

Winget

Install the YASB using winget install

winget install --id AmN.yasb

Using Python

• Install Python 3.12
• Install required Python Modules:
  • pip install -r requirements.txt
  • Create the directory C:/Users/{username}/.config/yasb/ and copy styles.css and config.yaml into folder. If you don't have the .config/yasb/ directory, on first run, the application will create it for you.
  • Configure styles.css and config.yaml to your liking.
• Start the application:
  • run python src/main.py in your terminal (or click yasb.vbs)

Demo YASB

for more themes visit yasb-themes

Demo YASB + Komorebi

[!NOTE] This repository is updated on a regular basis; when you update files, always check styles.css and config.yaml for new features and changes; otherwise, your config can be broken.

List of currently available widgets in YASB.

• Active Windows Title: Displays the title of the currently active window.
• Applications: Shows a list of predefined applications.
• Battery: Displays the current battery status.
• CPU: Shows the current CPU usage.
• Clock: Displays the current time and date.
• Custom: Create a custom widget.
• Github: Shows notifications from GitHub.
• Disk: Displays disk usage information.
• Language: Shows the current input language.
• Media: Displays media controls and information.
• Memory: Shows current memory usage.
• OBS: Integrates with OBS Studio to show recording status.
• Traffic: Displays network traffic information.
• Taskbar: A customizable taskbar for launching applications.
• Power Menu: A menu for power options.
• Volume: Shows and controls the system volume.
• Wallpapers: Allows changing wallpapers.
• Weather: Displays current weather information.
• WHKD: Shows the current hotkey.
• Komorebi Workspaces: Shows the current workspace.
• Komorebi Layout: Shows the current layout.

How to style

.widget .label {} -> Global label for all
.active-window-widget {} -> Styles specific to the active window widget
.clock-widget {} -> Styles specific to the clock widget
.cpu-widget {} -> Styles specific to the CPU widget
.memory-widget {} -> Styles specific to the memory widget
.weather-widget {} -> Styles specific to the weather widget
.komorebi-workspaces {} -> Styles specific to komorebi workspaces
.komorebi-active-layout {} -> Styles specific to komorebi active layout
.volume-widget {} -> Styles specific to the volume widget 
.apps-widget {} -> Styles specific to the apps widget
.power-menu-widget {} -> Styles for the power menu button widget
.power-menu-popup {} -> Styles for the power menu popup widget
.power-menu-popup > .button {} -> Styles for power buttons inside the popup 
.power-menu-popup > .button > .icon,
.power-menu-popup > .button > .label {} -> Styles for power buttons icons and labels inside the popup
.media-widget {} -> Styles specific to the media widget
.github-widget {} -> Styles specific to the github widget
.language-widget {} -> Styles specific to the language widget
.disk-widget {} -> Styles specific to the disk widget
.taskbar-widget {} -> Styles specific to the taskbar widget

Contributors

Thanks to our amazing contributors!