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 width and 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 running applications with visible windows
- Check filter settings in config.yaml
Performance Issues
Q: High CPU usage?
A: Common causes:
- Low update_interval values
- Too many real-time widgets
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