Configurazione — Liu Terminal

Configurazione di Liu Terminal. Personalizza temi, scorciatoie, caratteri e impostazioni tramite file di configurazione JSON.

config.json si trova in ~/.config/Liu/config.json. Le chiavi sono stringhe e numeri di primo livello piatti (non oggetti annidati). Liu lo carica all'avvio e lo ricarica automaticamente quando il file cambia su disco. Le chiavi sconosciute vengono ignorate.

Layout dei file

~/.config/Liu/
├── config.json        # impostazioni principali dell'app
├── keybindings.json   # scorciatoie personalizzate (vedi la pagina Scorciatoie)
├── known_hosts        # host conosciuti in formato OpenSSH
├── vault.db           # SQLite vault crittografato AES-256-GCM (derivazione PBKDF2)
└── themes/
    ├── my-theme.json
    └── ...

Campi di primo livello

theme string "Liu"

Nome del tema attivo. Deve corrispondere a uno dei 18 integrati o a un JSON in ~/.config/Liu/themes/.

font_path string "JetBrainsMono-Regular.ttf"

File del font primario. I nomi file semplici si risolvono nella directory fonts inclusa; anche i percorsi assoluti funzionano.

font_size number 16

Dimensione in punti prima del ridimensionamento DPI.

enable_ligatures boolean true

Attiva/disattiva la modellazione delle legature di programmazione.

cursor_style number 0

0 = block · 1 = underline · 2 = bar

cursor_blink boolean true

Lampeggia solo nei pannelli attivi.

scrollback number 1000

Righe per pannello (limitato 0–20000). La memoria cresce con cols × scrollback.

vault_auto_lock_minutes number 15

Blocco automatico dopo N minuti di inattività (0 = solo blocco manuale).

quake_mode boolean false

Abilita finestra a scorrimento stile Quake (richiede quake_hotkey).

quake_hotkey string "Ctrl+`"

Stringa di scorciatoia globale quando quake_mode è true.

Altre chiavi supportate

La tabella sopra mostra i valori modificati più spesso. Il loader accetta anche questi gruppi piatti di primo livello:

  • line_height, font_normalize, font_smoothing, font_weight and fallback_font_0 … fallback_font_3 control font metrics and fallback fonts. Defaults: 1.0, true, true, 0; font weight is clamped to 0–2.
  • tab_sleep_idle_minutes defaults to 20; confirm_close_agent, bold_is_bright, show_scrollbar, show_tab_bar, show_toolbar_icons and show_git_badge default to true. bidi_enabled, hide_title_bar and show_status_bar default to false.
  • sidebar_width defaults to 240 and is clamped to 160–500; opacity defaults to 1.0 and is clamped to 0.2–1.0; padding defaults to 2.
  • browser_enabled, browser_last_url and browser_recent_0 … browser_recent_7 store browser state. The in-app browser is available on the macOS WebKit build.
  • option_as_alt accepts off, left, right or both; prompt_recall accepts off, badge or always. cursor_animate defaults to false, notify_command_threshold to 10, and allow_osc52_write to false.
  • background_image, notes_vault_path, background_mode (stretch/center/tile/fill), background_opacity, background_blur and background_blur_radius configure the image layer. The defaults are empty path, empty path, fill, 0.3, false and 10.
  • quake_mode, quake_hotkey, quake_height_ratio and quake_animation_duration default to false, Ctrl+`, 0.4 and 0.2; their numeric ranges are 0.1–1.0 and 0–10.
  • profile_count plus profile_<index>_name, _font_path, _font_size, _theme, _cursor_style and _opacity define up to 16 profiles. Translate-on-Tab and Voice keys are documented on their dedicated pages.
  • site_count plus site_<index>_name, _path, _command and _port define up to 32 Site Manager entries; runtime process state is not persisted.

Anche chiavi di stile come style_tab_gap, style_sidebar_min_width e style_terminal_padding vengono salvate in config.json. Altezza della barra degli strumenti e larghezza delle schede sono costanti di layout a compile-time.

Esempio

{
  "theme": "Tokyo Night",
  "font_path": "JetBrainsMono-Regular.ttf",
  "font_size": 14,
  "enable_ligatures": true,
  "cursor_style": 2,
  "cursor_blink": false,
  "scrollback": 5000,
  "vault_auto_lock_minutes": 30,
  "quake_mode": true,
  "quake_hotkey": "Ctrl+`"
}

Il conteggio delle schede è limitato a 32 per finestra (MAX_TABS in src/ui/ui.h), non configurabile qui. Il backend GPU è scelto a compile-time (Metal su macOS, OpenGL altrove). I campi numerici come scrollback vengono limitati a intervalli sicuri al caricamento.

Torna a Introduzione ↺

Documentazione

Guida introduttiva

Guide

Riferimento

Altre lingue

English · Türkçe · 简体中文 · 한국어 · Español · Deutsch · Français · 日本語 · العربية