LEAN

Customize

Themes

Lean reads Ghostty's theme files, so it can look like your terminal.

Picking a theme

The Style page of the settings window (g,) lists the themes with their colours and shows each one live as you move through the list. gC or :colo jumps to another one at random.

What theme accepts

Value Result
"Gruvbox Dark"the Ghostty theme of that name
"ghostty"the theme set in your Ghostty config
"light:Catppuccin Latte,dark:Catppuccin Mocha"follows the appearance of macOS
"random"a different one at every start

Where themes come from

Lean looks in three places and takes the first file with the name:

  1. ~/.config/lean/themes, for themes only Lean should have
  2. ~/.config/ghostty/themes, your own Ghostty themes
  3. the themes that ship inside Ghostty.app

Without Ghostty installed, put theme files into the first folder. A theme file is plain text in Ghostty's format (background, foreground, palette).

Font

fontFamily and fontSize set the font of the sidebar and the status line. "fontFamily": "ghostty" takes the font from your Ghostty config.

More than colours

Setting Does
opacitybelow 1, the sidebar and status line show the blurred desktop
accentFromProjectselection and loading bar take the current project's colour
paintPages or gprepaints the pages themselves in the theme colours. Crude: it overrides the colours of every page. Good at night, wrong for anything where colour carries meaning.