General Usage

Gtheme offers two interfaces: a command-line interface (CLI) and a text user interface (TUI).

CLI

All commands follow the pattern gtheme <resource> <action> [args]. Most resources and actions have short aliases.

Desktop commands

gtheme desktop list                    # or: gtheme d l
gtheme desktop apply <desktop>         # or: gtheme d apply <desktop>
gtheme desktop apply <desktop> -t <theme>
gtheme desktop info [desktop]
gtheme desktop deps [desktop]          # List required dependencies
gtheme desktop deps [desktop] --all    # Include optional deps
gtheme desktop set-default-theme       # or: gtheme d sdt
gtheme desktop status                  # or: gtheme d s

Theme commands

gtheme theme list                      # or: gtheme t l
gtheme theme list --favs               # or: gtheme t l -f
gtheme theme apply <theme>             # or: gtheme t a <theme>
gtheme theme colors [theme]            # or: gtheme t c [theme]
gtheme theme new-skeleton <name>

Pattern commands

gtheme pattern list                    # or: gtheme p l
gtheme pattern enable <pattern>        # or: gtheme p e <pattern>
gtheme pattern disable <pattern>       # or: gtheme p d <pattern>
gtheme pattern toggle <pattern>        # or: gtheme p t <pattern>
gtheme pattern invert <pattern>        # or: gtheme p i <pattern>

Extra commands

gtheme extra list                      # or: gtheme e l
gtheme extra enable <extra>            # or: gtheme e e <extra>
gtheme extra disable <extra>           # or: gtheme e d <extra>

Config commands

gtheme config set <key> <value>
gtheme config show
gtheme config edit

Favorite commands

gtheme fav add <theme>
gtheme fav remove <theme>
gtheme fav list                        # or: gtheme fav l

Tip

Run gtheme --help or gtheme <subcommand> --help to see all available options for any command.

TUI

Launch the TUI by running gtheme with no arguments:

gtheme

Navigation

Key	Action
Tab	Switch between desktops/patterns and themes views
Arrow keys	Navigate items
Enter	Apply selected item
h	Show help
q	Quit

Tip

Press h inside the TUI to see all available keybindings.

Verbose output

Add -v for more detailed output, or -vv for very verbose:

gtheme theme apply Dracula -v
gtheme desktop apply hypr -vv

Applying themes to specific patterns

You can apply a theme to only specific patterns instead of all enabled ones:

gtheme theme apply Dracula -p kitty waybar-colors

You can also invert specific patterns during application:

gtheme theme apply Dracula -i sddm

Dry run

Preview what would happen without actually making changes:

gtheme theme apply Dracula --dry-run