FAQ - thesleepingsage/yasb-wiki GitHub Wiki

Frequently Asked Questions

Installation Issues

Q: Why aren't the icons showing up correctly?

A: This usually happens because:

  • Required Nerd Fonts are not installed or other font defined in styles.css
  • Recommended JetBrainsMono Nerd Font
  • Restart YASB after font installation

Q: Why doesn't the blur effect work?

A: Check these points:

  • Windows 10/11 transparency effects are enabled in system settings
  • The blur_effect is enabled in config.yaml
  • Your GPU drivers are updated
  • Windows composition is enabled

Configuration Issues

Q: Where are the configuration files located?

A: Default location: C:/Users/{username}/.config/yasb/ Required files:

  • config.yaml - Main configuration
  • styles.css - Visual styling

Q: How to set custom configuration directory?

A: Set the YASB_CONFIG_HOME environment variable to the desired directory path.

Q: YASB crashes after updating?

A: After updates:

  • Check release notes for breaking changes
  • Compare your config with the latest example config
  • Backup your configs before updating

Q: How to reset YASB settings?

A: Delete the config.yaml and styles.css files in the config directory. YASB will create new default files on the next run.

Q: How to change the bar position?

A: Modify the position value in config.yaml:

  • top - Top of the screen
  • bottom - Bottom of the screen

Q: How to check for updates?

A: Run yasbc update in the terminal to check for updates.

Q: How to change the bar size?

A: Adjust the bar height value in config.yaml to change the bar size.

Q: How to check logs for errors?

A: Check the yasb.log file in the config directory for errors. or run yasbc logs in the terminal.

Widget Issues

Q: Weather widget not working?

A: Verify:

  • Valid API key from weatherapi.com
  • Correct api_key and location in settings
  • Active internet connection

Q: Missing applications in Taskbar widget?

A: Note:

  • Only shows minimized windows
  • System tray apps won't appear
  • Check window_class filters in config

Performance Issues

Q: High CPU usage?

A: Common causes:

  • Low update_interval values
  • Too many real-time widgets
  • Both watch_config and watch_stylesheet enabled

Q: Delayed startup?

A: Solutions:

  • Use yasbc enable-autostart --task to create a scheduled task for YASB
  • Check startup programs for conflicts

Styling Issues

Q: How to customize appearance?

A: Edit styles.css:

.yasb-bar { /* Main bar */ }
.widget { /* All widgets */ }
.clock-widget { /* Specific widget */ }

Q: CSS not working?

A: Limitations:

  • Basic CSS properties supported
  • No advanced CSS3 features
  • Check syntax in styles.css
  • Restart YASB after changes

Getting Help