Skip to main content

Using Themes

Themes are TOML files in ~/.local/share/flume/themes/.

Shipped Themes

Flume ships with five themes in examples/themes/:
  • solarized-dark
  • gruvbox-dark
  • catppuccin-mocha
  • catppuccin-glass — transparent variant
  • miasma — dark organic palette
  • miasma-glass — transparent variant
Copy them to your themes directory to use them.

Importing Themes

Import color schemes from external sources (like Omarchy themes) with a single command:
This fetches the colors.toml from the GitHub repo, maps the color palette to Flume’s theme format, and generates both a solid and transparent (glass) variant:
Any GitHub repository with a colors.toml file containing the Omarchy format (accent, foreground, background, color0-15) is supported.

Transparent Backgrounds

Add transparent = true to a theme’s [meta] section to make all backgrounds use the terminal’s default (showing through to your wallpaper or background image):
Works with any terminal that supports transparency (iTerm2, Kitty, Alacritty, WezTerm, Ghostty with background-opacity). Set your terminal’s transparency/blur to taste.

Theme Format

Color Values

Colors can be:
  • Hex RGB: "#FF5500"
  • Named: black, red, green, yellow, blue, magenta, cyan, white
  • Bright variants: bright_red, bright_green, etc.

Nick Colors

Nick colors are assigned by hashing the nickname and indexing into the palette. This gives each nick a consistent color that persists across sessions. Colors are reused in large channels.

Generate a Theme with AI

See LLM Generation for setup.

Hot Reload

Themes are hot-reloadable — edit the TOML file and changes appear on the next render tick (~33ms). You can also force a reload: