FAQ_Waybar

FAQ for Waybar

Tip

Rename customized Waybar configs and styles so they are not overwritten during upgrades.

Missing Waybar modules on some layouts

Waybar layouts are unique. If a module is missing, you must add it manually or reorganize the modules to your preference.
Remember to rename your modified config and style files so you can easily restore them after an update.

Adjusting Waybar font size

Edit the font-size in the Waybar style files located in ~/.config/waybar/styles/.
By default, the font size is set to 97%. You can change this value (using % or px) to match your GTK font scaling preferences set in nwg-look.

12h vs 24h clock format

Edit ~/.config/waybar/modules and locate the clock entry.

• 12h format: Use %I:%M%P
• 24h format: Use %H:%M:%S

For more information on date formats, refer to the GNOME Gthumb documentation.

Editing specific layouts

Some Waybar layouts (e.g., Peony, Chrysanthemum, Camellia) have modules baked directly into their configuration files rather than using the main modules file.
Edit these files individually in ~/.config/waybar/configs.

Changing the Waybar keyboard layout module

The custom/keyboard module reads the kb_layout setting from your Settings.conf.
To add multiple layouts (e.g., kb_layout = us,es,ru), edit the file and refresh Waybar with SUPER + ALT + R. You can then switch layouts by left-clicking the keyboard module.

Removing unwanted modules

• Option 1: Edit ~/.config/waybar/modules and comment out the module with // or delete it.
• Option 2: Only modules defined in your current Waybar config are loaded. Edit the config and style files in ~/.config/waybar/configs and ~/.config/waybar/styles.

For more details, see the Customizing Waybar page.

Note

Do NOT edit ~/.config/waybar/config and ~/.config/waybar/style.css directly. They are symlinks to files in the configs/ and styles/ directories.

Waybar workspaces

Various workspace styles are available (Circle, Roman, Kanji, etc.). Assign your preference in your Waybar config. See ~/.config/waybar/modules for the module names (e.g., hyprland/workspaces#kanji).

Weather app for Waybar and Hyprlock

Weather.py is the default weather script. To switch between Weather.sh and Weather.py:

1. Edit ~/.config/waybar/ModulesCustom at the custom/weather entry.
2. Toggle the exec lines for .sh or .py.
3. If using Weather.sh, uncomment the exec-if: ping wttr.in line.
4. Refresh with SUPER + ALT + R.

To configure your location:

• Weather.sh: Edit ~/.config/hypr/UserScripts/Weather.sh and add your city. Delete ~/.cache/rbn and refresh Waybar.
• Weather.py: It automatically detects your location. You can tweak it by editing ~/.config/hypr/UserScripts/Weather.py.

Wallpaper and styling modules

• CTRL + ALT + W: Randomize wallpaper (or right-click the Waybar wallpaper module).
• SUPER + W: Select wallpaper (or click the Waybar wallpaper module).
• Right-click update module: Cycle wallpaper via swww.

Wallpaper scripts are located in ~/.config/hypr/UserScripts.

Waybar-Cava issues

If the Cava module is broken, your system locale may not be set properly.
Ensure /etc/locale.conf contains: LANG=en_US.UTF-8 (or your preferred locale).
Alternatively, run: sudo localectl set-locale LANG=en_US.UTF-8.

Waybar idle-inhibitor

Refer to the Waybar Wiki for more information.

Waybar CPU temperature source

To switch between Celsius and Fahrenheit, edit ~/.config/waybar/modules and update the temperature format to: "format": "{temperatureF}°F {icon}".

If the temperature is incorrect, update the hwmon-path or thermal_zone in the same file.
To list all available thermal zones, run:

for i in /sys/class/thermal/thermal_zone*; do echo "$i: $(<$i/type)"; done

To find a specific temperature source (e.g., K10temp for AMD or coretemp for Intel):

for i in /sys/class/hwmon/hwmon*/temp*_input; do echo "$(<$(dirname $i)/name): $(cat ${i%_*}_label 2>/dev/null || echo $(basename ${i%_*})) $(readlink -f $i)"; done

Then update the hwmon-path variable with the result.