Skip to content

Settings

The Settings tab edits global and local ublx.toml from the TUI. It is always available.

What fills each pane

PaneContent
LeftScope — Global vs Local
MiddleConfig keys for that scope (theme, layout, toggles, …)
RightDescription and preview for the selected key

Changes hot-reload where supported (see Configuration).

Common keys in the UI

KeyEffect
themePalette display name — Themes & palettes
layoutLeft / middle / right pane width percentages
bg_opacityPage background opacity (1.0 = solid)
show_hidden_filesInclude dotfiles in the index
hashBlake3 per file (duplicates / change detection)
follow_linksFollow directory symlinks on walk (v0.3.1+; default off; next snapshot)
run_snapshot_on_startupSnapshot when opening a catalog
typed_column_tablesMetadata column tables: none / abbrev / full
command_mode.leaderGlobal only — letter for Command Mode (Ctrl+{letter}; default a). Enter cycles; type a letter when focused. j/k blocked

Editing the file directly

KeyAction
eOpen the active scope’s config file in $EDITOR

Theme picker without leaving Settings: Command Mode → t (default Ctrl+A, t) — saves to local config on confirm.

UBLX · Nefaxer · ZahirScan