Settings
The Settings tab edits global and local ublx.toml from the TUI. It is always available.
What fills each pane
| Pane | Content |
|---|---|
| Left | Scope — Global vs Local |
| Middle | Config keys for that scope (theme, layout, toggles, …) |
| Right | Description and preview for the selected key |
Changes hot-reload where supported (see Configuration).
Common keys in the UI
| Key | Effect |
|---|---|
theme | Palette display name — Themes & palettes |
layout | Left / middle / right pane width percentages |
bg_opacity | Page background opacity (1.0 = solid) |
show_hidden_files | Include dotfiles in the index |
hash | Blake3 per file (duplicates / change detection) |
follow_links | Follow directory symlinks on walk (v0.3.1+; default off; next snapshot) |
run_snapshot_on_startup | Snapshot when opening a catalog |
typed_column_tables | Metadata column tables: none / abbrev / full |
command_mode.leader | Global only — letter for Command Mode (Ctrl+{letter}; default a). Enter cycles; type a letter when focused. j/k blocked |
Editing the file directly
| Key | Action |
|---|---|
| e | Open 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.
Related
- Configuration — full key reference
- Themes & palettes
- Layout & keys