Folder Structure

After installation, Gtheme’s files are placed in ~/.config/gtheme/:

~/.config/gtheme/
├── global_config.json
├── user_settings.toml
├── desktops/
├── themes/
└── wallpapers/

Directories

`desktops/`

Contains all installed desktop configurations. Each subdirectory is a complete desktop with dotfiles, patterns, post-scripts, and extras. See the Desktop Specification for the full structure.

`themes/`

Contains all theme TOML files — the 350+ color schemes that ship with Gtheme plus any custom themes you create. See the Theme Specification for the file format.

`wallpapers/`

Contains theme-specific wallpaper images, organized by theme name. Downloaded during installation if you chose to include them.

Files

`global_config.json`

Internal Gtheme configuration file that tracks the currently active desktop and theme.

`user_settings.toml`

Stores user preferences like font name, font size, monitor name, and other hardware-specific values. These values are available as placeholders in patterns.

Manage this file with:

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

See Favorites & Settings for the full list of available settings.