Skip to content

Themes

The color palettes the terminal UI ships with and how to pick one.

The terminal UI renders in one of a few fixed color palettes. You don't have to configure anything to get a sensible default, but if your terminal picks the wrong one or you want a specific look, the --theme flag and the auto-detection below give you control. This page lists the palettes the TUI actually ships with and explains how it chooses between them.

Palettes

Three palettes are built in:

ThemeWhat it looks like
darkA dark palette based on GitHub's Dark Default colors. This is the fallback whenever a theme can't be resolved.
lightA light palette based on GitHub's Light Default colors, for bright terminals.
high-contrastA black-and-white base with bold, maximally distinct accent colors, aimed at accessibility.

Choosing a theme

Pass --theme to start the TUI in a specific palette:

bash
diffgazer --theme high-contrast --tui

--theme accepts auto, dark, light, or high-contrast, and only works alongside --tui. Run it on its own, or pass another value, and the CLI exits with an error. The web UI manages its own theme.

If you don't pass a theme, the TUI starts in auto and tries to match your terminal. Auto-detection reads the COLORFGBG environment variable that many terminals set, takes the background value from it, and picks light when that value points at a light background; otherwise it stays on dark.

Info:

Note: The settings schema accepts auto, dark, light, and terminal. The TUI normalizes terminal to auto. high-contrast is available from the CLI for the current run, but cannot be saved in config yet.

Related