Themes

Using Themes

/theme                  # list available themes
/theme solarized-dark   # switch theme
/theme reload           # hot-reload current theme

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:

/theme import https://github.com/OldJobobo/omarchy-miasma-theme

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:

Imported theme: omarchy-miasma-theme
  Saved: omarchy-miasma-theme.toml
  Saved: omarchy-miasma-theme-glass.toml
Switching to imported theme...

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):

[meta]
name = "my-glass"
transparent = true

[elements]
# foreground colors still apply normally
chat_message = "#cdd6f4"
# ... but all _bg colors become Color::Reset

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

[meta]
name = "my-theme"
description = "A custom theme"
author = "Your Name"
version = "1.0"

[colors]
background = "#1a1b26"
foreground = "#c0caf5"
title_bar_bg = "#1a1b26"
title_bar_fg = "#7aa2f7"
status_bar_bg = "#1a1b26"
status_bar_fg = "#565f89"
input_bg = "#1a1b26"
input_fg = "#c0caf5"
buffer_list_bg = "#1a1b26"
buffer_list_fg = "#a9b1d6"
active = "#7aa2f7"
inactive = "#565f89"
unread = "#e0af68"
chat_timestamp = "#565f89"
chat_message = "#c0caf5"
chat_own_nick = "#7aa2f7"
chat_action = "#bb9af7"
chat_server = "#565f89"
chat_system = "#e0af68"
chat_highlight = "#f7768e"
chat_url = "#73daca"
scroll_indicator = "#565f89"
search_match_fg = "#1a1b26"
search_match_bg = "#e0af68"
nick_list_fg = "#c0caf5"
nick_list_op = "#f7768e"
nick_list_voice = "#9ece6a"

[nick_colors]
mode = "hash"
palette = ["#f7768e", "#ff9e64", "#e0af68", "#9ece6a", "#73daca", "#7aa2f7", "#bb9af7"]

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

/generate theme dark blue background with warm orange accents

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:

/theme reload

Getting Started

Configuration

Scripting

Commands

Using Themes

Shipped Themes

Importing Themes

Transparent Backgrounds

Theme Format

Color Values

Nick Colors

Generate a Theme with AI

Hot Reload

​Using Themes

​Shipped Themes

​Importing Themes

​Transparent Backgrounds

​Theme Format

​Color Values

​Nick Colors

​Generate a Theme with AI

​Hot Reload

Using Themes

Shipped Themes

Importing Themes

Transparent Backgrounds

Theme Format

Color Values

Nick Colors

Generate a Theme with AI

Hot Reload