Skip to main content

​
File Locations

​
Config (~/.config/flume/)

PathPurpose
config.tomlMain settings (UI, keybindings, notifications, LLM, DCC)
irc.tomlNetwork/server definitions

​
Data (~/.local/share/flume/)

PathPurpose
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.tomlEncrypted secrets
logs/IRC message logs
sts_policies.tomlSTS 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.1.0"
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
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.