Configuration
Termuna reads ~/.config/termuna/config.toml
(override the path with the TERMUNA_CONFIG environment
variable). No config file is required: everything below shows the
defaults. A broken config never blocks startup - Termuna logs a warning
and uses defaults.
The full reference
[font]
size = 14.0
# Cell height as a multiple of font size.
line_height = 1.32
[theme]
# Built-in themes: "luna-dark" (default), "luna-light", "dracula",
# "nord", "gruvbox-dark", "solarized-dark", "tokyo-night".
# Pick these in-app under settings.
name = "luna-dark"
# Lines of scrollback kept per pane (max 1,000,000).
scrollback_lines = 10000
[ui]
# Written by the app, listed here so nothing in the file is a mystery.
# The window reopens the way it was closed: size, maximized state, and
# the session that was on screen. First-launch defaults:
window_width = 1440.0
window_height = 860.0
window_maximized = false
# last_session = "<uuid>"
drawer_pinned = true
continuity_pinned = true
# Behaviour knobs the app does not surface in settings (yet).
[terminal]
# Ask before pasting text with newlines: a paste is keystrokes, and the
# second command runs before the first can be read.
warn_on_multiline_paste = true
# Drop the trailing newline/whitespace a copied line brings with it.
trim_paste = true
# What a double-click treats as the end of a word (paths and URLs stay
# whole with these).
word_separators = " ()[]{}'\"`,;:|<>"
# Lowest WCAG contrast ratio a cell may render at; the foreground is
# lifted until it clears. 1.0 = never touch the scheme's colours.
min_contrast = 1.0
# Read "NN%" out of pane output and show it in the status bar.
detect_progress = true
# The per-pane "Notify when this quiets down" watch is a menu action
# (right-click a pane), not a setting: no key here controls it.
# Desktop notifications about panes you cannot see. notify_when_done
# covers a command that ran >=15s finishing, and a bell.
# notify_on_activity additionally pings on the first output of a quiet
# background tab.
notify_on_activity = false
notify_when_done = true
[quake]
# A global OS-wide hotkey that shows / hides the Termuna window.
# Off unless set. Same "modifiers+key" grammar as keybindings.
# hotkey = "F12"
[cloud]
# Termuna Cloud session continuity. OFF by default: nothing ever leaves
# this machine unless you turn it on. The in-app sign-in writes this
# section for you.
enabled = false
url = "wss://termuna.com/v1/session"
share_base = "https://termuna.com/s"
[keybindings]
# "modifiers+key" = "action"; chords with ">". See the Keybindings page. Notes
- The
[ui]section is written by the app as you use it; you rarely edit it by hand. It is documented so nothing in the file is a mystery. - Share links for synced sessions are written next to each session
file in
~/.local/share/termuna/sessions/as<id>.cloudurl. - Every value above is the default: a minimal config that only changes the theme is two lines long.