YASB GUI AmN

Use this command to install YASB GUI:

winget install --id=AmN.YASBGUI -e

A graphical configuration manager for YASB Reborn.

YASB GUI

YASB GUI is a native configuration application for YASB Reborn (Yet Another Status Bar). Built with WinUI 3, it provides a modern interface for managing your status bar configuration without manually editing YAML files.

> Note: This application is currently in beta. Some features may be incomplete or subject to change. Please report any issues on the GitHub Issues page.

Why a separate repository?

YASB GUI is maintained separately from YASB for several reasons:
Built with WinUI 3, which requires Windows App SDK dependencies not needed by YASB itself
Keeps YASB lightweight and focused on its core functionality without GUI framework bloat
Allows independent development cycles and easier maintenance for both projects
Users who prefer manual YAML editing don't need to install unnecessary GUI dependencies

Features

Visual Configuration Editor

Edit bars, widgets, and global settings through an intuitive interface
Monaco-based code editor with YAML syntax highlighting and validation
Real-time schema validation for configuration files

Widget Management

Add, remove, and configure widgets with a visual editor
Support for all YASB widget types
Widget-specific settings panels

Styles Editor

Built-in CSS editor for customizing your status bar appearance
Syntax highlighting and auto-completion

Environment Variables

Manage environment variables used by YASB
Easy key-value editing interface

Application Settings

Light, Dark, and System theme support
Multiple backdrop options: Mica, Mica Alt, and Acrylic
Multi-language support

Safety Features

Export configuration as ZIP backup
Unsaved changes detection with confirmation dialogs
Configuration validation before save

System Requirements

Component	Requirement
Operating System	Windows 10 (Build 17763+) or Windows 11
Runtime	Windows App SDK Runtime
WebView	Microsoft Edge WebView2 Runtime (included with Windows 10/11)

Installation

Download the latest release from the Releases page.

Add a widget using a docs snippet (how it actually works)

Go to Widgets → Add Widget.
Pick the widget from the built-in list.
In the Options editor, paste only the options block from the docs-not the outer widgets: list. Real example (Weather widget) with nested options and indentation kept:

label: "{icon} {temp}"
label_alt: "{location}: Min {min_temp}, Max {max_temp}"
api_key: "YOUR_API_KEY"
show_alerts: true
tooltip: true
update_interval: 600
hide_decimal: true
units: metric
menu:
  blur: true
  round_corners: true
  round_corners_type: normal
  border_color: system
  alignment: center
  direction: down
  offset_top: 6
  offset_left: 0
icons:
  sunnyDay: "\ue30d"
  clearNight: "\ue32b"
  cloudyDay: "\ue312"
  cloudyNight: "\ue311"
  rainyDay: "\ue318"
  rainyNight: "\ue318"
  snowyIcy: "\ue31a"
  default: "\ue137"
callbacks:
  on_left: toggle_menu

Save the widget, then hit Apply so YASB reloads the updated config.

> Tips > > Copy only the options section from the docs and paste it into the Options editor; the widget type is already set by your selection. > > If indentation looks off, right-click in the editor and choose Fix indentation from the context menu.

Configuration

The application reads and writes YASB configuration from:

~/.config/yasb/config.yaml
~/.config/yasb/styles.css

To use a custom location, set the YASB_CONFIG_HOME environment variable.

Contributing Translations

YASB GUI supports multiple languages. Translation files are located in app/core/locales/.

To add a new language:

Copy en.json and rename it using the language code (e.g., fr.json for French)
Update _language_name and _language_code at the top of the file
Translate all string values while keeping the keys unchanged
Do not modify placeholders (e.g., {variable}) within the strings
Do not chnage the JSON structure
Submit a pull request

Building from Source

Development Setup

git clone https://github.com/amnweb/yasb-gui.git
cd yasb-gui
pip install -e .
python app/main.py

Building Executable

pip install .[build]
python app/scripts/build.py build

The executable will be created in the dist/ directory.

Building MSIX Package

After building the executable, you can create an MSIX package:

python app/scripts/build_msix.py

The MSIX will be created in the msix/ directory.

Options:

--arch x64|aarch64 - Target architecture (default: x64)
--output - Output directory for MSIX

Local Development (Unsigned MSIX)

For local testing without code signing, register the package in development mode:

# Register the package (runs from extracted layout, not the .msix file)
Add-AppxPackage -Path "msix/layout/AppxManifest.xml" -Register

# Launch the app
Start-Process "shell:AppsFolder\YASB.GUI_wbnnev551gwxy!App"

# Uninstall when done
Get-AppxPackage -Name "YASB.GUI" | Remove-AppxPackage

Local Signing (Optional)

To test with a signed MSIX locally, create a self-signed certificate:

# Create a self-signed certificate (run once)
$cert = New-SelfSignedCertificate -Type Custom -Subject "CN=YourName" `
  -KeyUsage DigitalSignature -FriendlyName "YASB GUI Dev" `
  -CertStoreLocation "Cert:\CurrentUser\My" `
  -TextExtension @("2.5.29.37={text}1.3.6.1.5.5.7.3.3")

# Export to PFX (set a password)
$pwd = ConvertTo-SecureString -String "YourPassword" -Force -AsPlainText
Export-PfxCertificate -Cert $cert -FilePath "dev-cert.pfx" -Password $pwd

# Trust the certificate (required to install signed packages)
Import-Certificate -FilePath (Export-Certificate -Cert $cert -FilePath "dev-cert.cer") `
  -CertStoreLocation "Cert:\LocalMachine\TrustedPeople"

# Sign the MSIX
&amp; "C:\Program Files (x86)\Windows Kits\10\bin\10.0.22621.0\x64\signtool.exe" sign `
  /fd SHA256 /a /f "dev-cert.pfx" /p "YourPassword" "msix\yasb-gui-0.0.2-x64.msix"

# Install the signed MSIX
Add-AppxPackage -Path "msix\yasb-gui-0.0.2-x64.msix"

> Note: Update the Publisher in build_msix.py to match your certificate's CN if signing locally.

Support the Project

If you find YASB GUI useful, consider supporting its development:

Your support helps maintain and improve the project.