# 설정 — Liu Terminal

> Liu Terminal 설정. JSON 구성 파일을 통해 테마, 단축키, 글꼴, 설정을 사용자 정의하세요.

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

config.json은 ~/.config/Liu/config.json에 있습니다. 키는 평면적인 최상위 문자열과 숫자입니다(중첩 객체 아님). Liu는 실행 시 로드하고 파일이 디스크에서 변경되면 자동으로 다시 읽습니다. 알 수 없는 키는 무시됩니다.

## 파일 레이아웃

```
~/.config/Liu/
├── config.json        # 메인 앱 설정
├── keybindings.json   # 사용자 지정 키 바인딩 (단축키 페이지 참조)
├── known_hosts        # OpenSSH 형식의 알려진 호스트
├── vault.db           # AES-256-GCM 암호화된 SQLite 금고(PBKDF2 키 유도)
└── themes/
    ├── my-theme.json
    └── ...
```

## 최상위 필드

`theme` string `"Liu"`

활성 테마 이름. 18개 내장 테마 중 하나 또는 ~/.config/Liu/themes/의 JSON 파일과 일치해야 합니다.

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

기본 글꼴 파일. 파일명만 있으면 번들 fonts 디렉터리 기준으로 해석되며, 절대 경로도 가능합니다.

`font_size` number `16`

DPI 스케일링 전 포인트 크기.

`enable_ligatures` boolean `true`

프로그래밍 합자 셰이핑 전환.

`cursor_style` number `0`

0 = block · 1 = underline · 2 = bar

`cursor_blink` boolean `true`

포커스된 창에서만 깜박임.

`scrollback` number `1000`

창당 줄 수(0–20000으로 제한). 메모리는 cols × scrollback에 비례해 증가합니다.

`vault_auto_lock_minutes` number `15`

유휴 상태 N분 후 자동 잠금 (0 = 수동 잠금만).

`quake_mode` boolean `false`

Quake 스타일 슬라이드 다운 창 활성화 (quake\_hotkey 필요).

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

quake\_mode가 true일 때 전역 단축키 문자열.

## 기타 지원 키

위 표는 가장 자주 편집하는 값을 보여줍니다. 로더는 다음과 같은 평면 최상위 그룹도 허용합니다:

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

style\_tab\_gap, style\_sidebar\_min\_width, style\_terminal\_padding 같은 스타일 키도 config.json에 저장됩니다. 툴바 높이와 탭 너비는 컴파일 시 레이아웃 상수이며 구성 키가 아닙니다.

## 예시

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

탭 수는 창당 32로 고정되어 있습니다(src/ui/ui.h의 MAX\_TABS) — 여기서 설정할 수 없습니다. GPU 백엔드는 컴파일 시 결정됩니다(macOS는 Metal, 그 외는 OpenGL). scrollback 같은 숫자 필드는 로드 시 안전 범위로 제한됩니다.

[돌아가기 소개 ↺](https://liu.software/ko/docs.md)