설정 — Liu Terminal

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

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 같은 숫자 필드는 로드 시 안전 범위로 제한됩니다.

돌아가기 소개 ↺

문서

시작하기

가이드

참조

다른 언어

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