Configuración — Liu Terminal

Configuración de Liu Terminal. Personalice temas, atajos, fuentes y ajustes mediante un archivo de configuración JSON.

config.json reside en ~/.config/Liu/config.json. Las claves son cadenas y números de nivel superior planos (no objetos anidados). Liu lo carga al inicio y lo recarga automáticamente cuando el archivo cambia en disco. Las claves desconocidas se ignoran.

Estructura de archivos

~/.config/Liu/
├── config.json        # ajustes principales de la app
├── keybindings.json   # atajos personalizados (consulte la página de Atajos)
├── known_hosts        # hosts conocidos en formato OpenSSH
├── vault.db           # bóveda SQLite cifrada AES-256-GCM (derivación PBKDF2)
└── themes/
    ├── my-theme.json
    └── ...

Campos de nivel superior

theme string "Liu"

Nombre del tema activo. Debe coincidir con uno de los 18 integrados o un JSON en ~/.config/Liu/themes/.

font_path string "JetBrainsMono-Regular.ttf"

Archivo de fuente principal. Los nombres simples se resuelven contra el directorio fonts incluido; las rutas absolutas también funcionan.

font_size number 16

Tamaño en puntos antes del escalado DPI.

enable_ligatures boolean true

Alternar el modelado de ligaduras de programación.

cursor_style number 0

0 = block · 1 = underline · 2 = bar

cursor_blink boolean true

Parpadea solo en los paneles enfocados.

scrollback number 1000

Líneas por panel (limitado 0–20000). La memoria crece con cols × scrollback.

vault_auto_lock_minutes number 15

Bloqueo automático tras N minutos de inactividad (0 = solo bloqueo manual).

quake_mode boolean false

Habilitar ventana deslizante estilo Quake (requiere quake_hotkey).

quake_hotkey string "Ctrl+`"

Cadena de tecla global cuando quake_mode es true.

Otras claves compatibles

La tabla anterior muestra los valores editados con más frecuencia. El cargador también acepta estos grupos planos de nivel superior:

  • 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.

Las claves de estilo como style_tab_gap, style_sidebar_min_width y style_terminal_padding también se guardan en config.json. La altura de la barra de herramientas y el ancho de las pestañas son constantes de diseño en tiempo de compilación.

Ejemplo

{
  "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+`"
}

El recuento de pestañas está limitado a 32 por ventana (MAX_TABS en src/ui/ui.h), no configurable aquí. El backend GPU se elige en tiempo de compilación (Metal en macOS, OpenGL en otros). Los campos numéricos como scrollback se limitan a rangos seguros al cargar.

Volver a Introducción ↺

Documentación

Empezando

Guías

Referencia

Otros idiomas

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