Theme settings are named settings objects stored at $HOME/.config/qtermy/themes. Themes can be created and edited from the Theme Editor dialog. The files can also be edited directly in a text editor, but note that qtermy does not monitor for external changes to settings files. Use the reload files button in the Theme Editor dialog to load external changes and new files without restarting the application.

A theme is a predefined color palette that can be quickly applied to a profile using the profile editor or directly to a terminal using the Adjust Colors dialog. Applying a theme to a profile or terminal sets both the Palette and Dircolors.

Note that each profile and terminal has its own palette and dircolors, separate from any theme. Changing a theme does not modify any profile or terminal settings, and it's possible for a profile or terminal to have settings that do not match any defined theme. In this case, the theme will be displayed as "Custom Color Theme" in the settings editor at the Palette setting (for profiles) and in the Adjust Colors dialog (for terminals).


Group (string)

A string describing the group that the theme belongs to. This is used with the SameGroup parameter to RandomTerminalTheme to select a random theme that belongs to the same group as the terminal's existing theme.

To see what group names are already defined, use the Theme Editor dialog or grep the settings files directly. The default (untranslated) group names used by qtermy's built-in themes are:

  • Light background
  • Dark background
Palette (string)

The theme's color palette, in the same format as a profile's Palette.

Dircolors (string)

The theme's dircolors, in the same format as a profile's Dircolors.

LowPriority (boolean)

If enabled, the theme will be shown at the bottom of the list in the Theme Editor dialog and in theme selection dropdowns. Enable this setting in themes that only exist to be used with the RandomTerminalTheme action.