Favorites & Settings

Favorites

With 350+ themes, favorites let you bookmark the themes you use most for quick access.

Managing favorites

gtheme fav add <theme>       # Add a theme to favorites
gtheme fav remove <theme>    # Remove a theme from favorites
gtheme fav list              # List all favorite themes

Using favorites

In the CLI, list only your favorites:

gtheme theme list --favs

In the TUI, the themes view shows your favorites in a separate section at the top for quick access.

User settings

User settings store hardware-specific and personal preference values that vary between machines. They’re saved in ~/.config/gtheme/user_settings.toml and available as placeholders in patterns.

Managing settings

gtheme config set <key> <value>   # Set a value
gtheme config show                # Show all current settings
gtheme config edit                # Open settings file in your editor

Common settings

Key	Description	Example
`default-font`	Font family used in patterns	`GeistMono Nerd Font`
`default-font-size`	Font size used in patterns	`11`
`monitor`	Primary monitor name	`eDP-2`
`monitor-fallback`	Fallback monitor	`HDMI-0`
`backlight-card`	Backlight device for brightness	`intel_backlight`
`battery`	Battery device name	`BAT0`
`battery-adapter`	Power adapter name	`AC0`
`terminal`	Default terminal emulator	`kitty`
`browser`	Default browser	`firefox`
`file-explorer`	Default file manager	`yazi`
`network-if`	Network interface	`wlo1`

Using settings in patterns

Reference any setting in a pattern with a fallback value:

font_family <[default-font|JetBrains Mono]>
font_size <[default-font-size|12]>

If the setting exists in user_settings.toml, its value is used. Otherwise, the fallback value after | is used.

Custom settings

You can define any key-value pair — settings aren’t limited to the common ones listed above. If your desktop needs a custom value (like a DPI setting or a specific path), just set it:

gtheme config set dpi 120

Then reference it in patterns:

Xft.dpi: <[dpi|96]>