# Configuration — Liu Terminal

> Configuration de Liu Terminal. Personnalisez les thèmes, les raccourcis, les polices et les paramètres via un fichier de configuration JSON.

URL: https://liu.software/fr/docs/config/  
Language: fr  
Updated: 2026-10-17

config.json se trouve dans ~/.config/Liu/config.json. Les clés sont des chaînes et nombres de niveau supérieur plats (pas d'objets imbriqués). Liu le charge au lancement et le recharge automatiquement quand le fichier change sur le disque. Les clés inconnues sont ignorées.

## Disposition des fichiers

```
~/.config/Liu/
├── config.json        # paramètres principaux de l'application
├── keybindings.json   # raccourcis clavier personnalisés (voir la page Raccourcis)
├── known_hosts        # hôtes connus au format OpenSSH
├── vault.db           # coffre-fort SQLite chiffré AES-256-GCM (dérivation PBKDF2)
└── themes/
    ├── my-theme.json
    └── ...
```

## Champs de niveau supérieur

`theme` string `"Liu"`

Nom du thème actif. Doit correspondre à l'un des 18 intégrés ou à un JSON dans ~/.config/Liu/themes/.

`font_path` string `"JetBrainsMono-Regular.ttf"`

Fichier de police principal. Les noms simples sont résolus par rapport au répertoire fonts fourni; les chemins absolus fonctionnent aussi.

`font_size` number `16`

Taille en points avant la mise à l'échelle DPI.

`enable_ligatures` boolean `true`

Basculer la mise en forme des ligatures de programmation.

`cursor_style` number `0`

0 = block · 1 = underline · 2 = bar

`cursor_blink` boolean `true`

Clignote uniquement dans les volets focalisés.

`scrollback` number `1000`

Lignes par volet (borné 0–20000). La mémoire croît avec cols × scrollback.

`vault_auto_lock_minutes` number `15`

Verrouillage automatique après N minutes d'inactivité (0 = verrouillage manuel uniquement).

`quake_mode` boolean `false`

Activer la fenêtre coulissante style Quake (nécessite quake\_hotkey).

`quake_hotkey` string ``"Ctrl+`"``

Chaîne de raccourci global quand quake\_mode est true.

## Autres clés prises en charge

Le tableau ci-dessus présente les valeurs les plus souvent modifiées. Le chargeur accepte également ces groupes plats de niveau supérieur:

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

Les clés de style comme style\_tab\_gap, style\_sidebar\_min\_width et style\_terminal\_padding sont également persistées dans config.json. La hauteur de la barre d’outils et la largeur des onglets sont des constantes de mise en page à la compilation.

## Exemple

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

Le nombre d'onglets est plafonné à 32 par fenêtre (MAX\_TABS dans src/ui/ui.h) — non configurable ici. Le backend GPU est choisi à la compilation (Metal sur macOS, OpenGL ailleurs). Les champs numériques comme scrollback sont limités à des plages sûres au chargement.

[Retour à Introduction ↺](https://liu.software/fr/docs.md)