Configuration Overview - Flume

File Locations

Config (`~/.config/flume/`)

Path	Purpose
`config.toml`	Main settings (UI, keybindings, notifications, LLM, DCC)
`irc.toml`	Network/server definitions

Path	Purpose
`themes/`	Theme files (TOML)
`layouts/`	Saved split layout profiles
`scripts/lua/autoload/`	Lua scripts loaded on startup
`scripts/python/autoload/`	Python scripts loaded on startup
`scripts/available/`	Installed but not auto-loaded
`scripts/generated/`	Created by `/generate script`
`vault.toml`	Encrypted secrets
`logs/`	IRC message logs
`sts_policies.toml`	STS policy cache

Flume uses XDG directories: $XDG_CONFIG_HOME/flume and $XDG_DATA_HOME/flume.

Example config.toml

[general]
default_nick = "mynick"
alt_nicks = ["mynick_", "mynick__"]
realname = "My Name"
quit_message = "Flume IRC"
timestamp_format = "%H:%M:%S"
scrollback_lines = 10000

[ui]
theme = "solarized-dark"
show_nick_list = true
show_join_part = true
show_hostmask_on_join = true

[ui.keybindings]
mode = "emacs"

[logging]
enabled = true
format = "plain"
rotate = "daily"

[notifications]
highlight_bell = true
highlight_words = ["mynick"]
notify_private = true
notify_highlight = true

[ctcp]
version_reply = "Flume 1.2.5"
respond_to_version = true
respond_to_ping = true

[llm]
provider = "anthropic"
model = "claude-sonnet-4-20250514"

[dcc]
enabled = false
download_directory = "~/Downloads/flume"
passive = true

[combos]
alert = "%B%Cred,white"
info = "%Ccyan"

[combos.rainbow]
type = "cycle"
colors = ["red", "orange", "yellow", "green", "cyan", "blue", "purple", "pink"]

All fields have sensible defaults — an empty config file works fine.

Changing Settings at Runtime

Use /set to view and change settings without editing the file:

/set ui.theme catppuccin-glass
/set ui.show_join_part false
/set notifications.highlight_bell false

Changes are saved to config.toml immediately. See Settings Command for details.