FAQ_Themes_and_Decorations

FAQ for Decorations and Theming

Hyprland and Plasma QT apps theming

If you have installed Hyprland alongside KDE/Plasma, refer to the Customizing QT Apps Theming page.

Adjusting font sizes and scaling

nwg-look is recommended for GTK settings. For QT apps, use qt5ct or qt6ct.

For HiDPI users:

• Adjust scaling in ~/.config/hypr/monitors.conf or use nwg-displays.
• Adjust font size using nwg-look (GTK Settings).
• Tweak font scaling in the Font tab in nwg-look.
• Adjust Waybar font sizes in ~/.config/waybar/styles/.
• Adjust Kitty font size in ~/.config/kitty/kitty.conf.

GTK and QT apps theming

• GTK: Use nwg-look (GTK Settings). Note that the DarkLight.sh script (~/.config/hypr/scripts) switches themes based on "Light" and "Dark" keywords in ~/.themes and ~/.icons.
• QT: Use qt5ct, qt6ct, and Kvantum Manager. By default, the QT theme is set to Catppuccin-Mocha via Kvantum.

Flatpak GTK themes

If Flatpak apps do not honor the Dark/Light theme switcher, execute these commands in your terminal:

sudo flatpak override --filesystem=$HOME/.themes
sudo flatpak override --filesystem=$HOME/.icons

Zsh shell customization

If you use Zsh, you can customize the theme using SUPER + SHIFT + O to pop up the theme menu.
Preview themes on the Oh My Zsh wiki.

Wallust color change in TTY or Kitty

By default, TTY and Kitty Wallust color changes are disabled. To make them permanent, edit ~/.config/kitty/kitty.conf and uncomment include kitty-colors.conf.
To change TTY colors after a wallpaper change, edit ~/.config/hypr/scripts/WallustSwww.sh and remove the -s flag from wallust run "$wallpaper_path" -s &.

Broken themes after installing

Check the contents of ~/.themes and ~/.icons. If they are empty, download them from the GTK Themes & Icons repository.
Use the dark/light button on Waybar or nwg-look to adjust your settings. Ensure your custom themes and icons include the "-Dark" or "-Light" keyword if you want to use the automated switching script.

Adjusting opacity

• Edit ~/.config/hypr/UserConfigs/UserDecorations.conf to change inactive_opacity (default 0.9).
• Disable opacity per-application in ~/.config/hypr/UserConfigs/WindowRules.conf.
• Temporarily toggle opacity for the active window with SUPER + ALT + O.
• Change Kitty opacity in ~/.config/kitty/kitty.conf.

Changing border colors and decorations

Edit ~/.config/hypr/UserConfigs/UserDecorations.conf.
By default, colors are sourced from wallust. To use custom colors, comment out the source = $HOME/.config/hypr/wallust/wallust-hyprland.conf line and set your own colors using hex values. Refer to the Hyprland Wiki for details.

Note

You must disable Rainbow Borders for these changes to take effect.