# 설치 — Liu Terminal

> macOS에 Liu Terminal을 설치하세요. Apple Silicon 또는 Intel용 DMG를 다운로드하거나 Homebrew로 설치하세요.

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

macOS 또는 Linux에 Liu를 설치하세요 — 다운로드 메뉴에서 패키지 빌드를 받거나 1분 이내에 소스에서 빌드하세요.

## 설치

다운로드 메뉴에서 패키지 빌드를 받거나(Apple Silicon / Intel용 macOS .dmg, Linux .tar.gz) 패키지 관리자를 사용하세요:

```
# macOS (Homebrew)
brew install --cask calculusteam/liu/liu

# Arch (AUR)
paru -S liu-bin

# Debian/Ubuntu (PPA)
sudo add-apt-repository ppa:calculusteam/liu && sudo apt update && sudo apt install liu

# Fedora (COPR)
sudo dnf copr enable calculusteam/liu && sudo dnf install liu
```

패키지 관리자 명령이 모든 릴리스에서 저장소를 사용할 수 있음을 보장하지는 않습니다. 아래 소스 빌드 경로는 해당 저장소와 무관합니다.

macOS 빌드는 Developer ID로 서명되고 Apple의 공증을 받았습니다 — Liu.app은 Gatekeeper 경고 없이 열립니다.

또는 스크립트로 최신 서명 빌드를 설치하세요(대체):

```
curl -fsSL https://raw.githubusercontent.com/calculusteam/liu/main/scripts/install.sh | bash
```

## 소스에서 빌드

저장소 루트에서 빌드 도우미는 플랫폼을 감지하고 기본적으로 Release 기준을 선택합니다:

```
./scripts/build.sh --yes      # recommended non-interactive build
./scripts/build.sh --debug    # Debug build
./scripts/build.sh --native   # host CPU tuning
./scripts/build.sh --package  # Release build + macOS DMG/Linux tarball
```

직접 CMake를 사용하는 경로:

```
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu 2>/dev/null || nproc)
./build/Liu
```

## 필수 조건

- CMake 3.20+
- C11 컴파일러 - Apple clang, 메인라인 clang 또는 gcc 10+
- `libssh2` (CMake가 시스템 라이브러리 또는 번들 빌드를 선택)
- Linux에는 OpenSSL/libcrypto, X11 및 OpenGL 개발 패키지도 필요합니다. Debian/Ubuntu 예: libssh2-1-dev libssl-dev libx11-dev libxcursor-dev libxrandr-dev libgl-dev pkg-config.

SQLite3, stb\_truetype, stb\_image 및 cJSON은 third\_party/에 포함되어 있어 별도로 설치할 필요가 없습니다.

## macOS — 주요 대상

```
brew install libssh2
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu)

./build/Liu
```

릴리스 빌드는 LTO와 -O3를 추가합니다. 기본은 이식 가능한 베이스라인입니다. x86\_64에서 -march=native를 원하면 cmake에 -DLIU\_NATIVE\_ARCH=ON을 전달하세요(Apple arm64는 -mcpu=apple-m1). 디버그 빌드는 Release를 Debug로 바꾸세요.

## Linux

```
sudo apt install cmake build-essential libssh2-1-dev
git clone https://github.com/calculusteam/liu.git && cd liu

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)

./build/Liu
```

Metal 백엔드는 macOS가 아닌 환경에서 건너뛰며 OpenGL 3.3 코어 렌더러가 사용됩니다. macOS에서도 OpenGL을 강제하려면 -DUSE\_METAL=OFF를 전달하세요.

## 유용한 플래그

```
cmake -B build -DUSE_ASM=OFF        # SIMD 어셈블리 건너뛰기
cmake -B build -DUSE_METAL=OFF      # macOS에서 OpenGL 강제
cmake -B build -DUSE_LIBFUZZER=ON   # libFuzzer 하네스 활성화
```

```
cmake -B build -DLIU_NATIVE_ARCH=ON       # tune Release for this CPU
cmake -B build -DLIU_BROWSER=OFF             # disable the macOS WebKit browser
cmake -B build -DUSE_VENDORED_SSH_DEPS=OFF  # use system SSH/crypto deps
cmake -B build -DAUTO_DOWNLOAD_SSH_DEPS=OFF # do not bootstrap missing macOS deps
```

## 동반 바이너리

단일 최상위 빌드로 메인 앱 옆에 두 개의 동반 바이너리가 생성됩니다:

```
cmake --build build --target liu-notify   # 알림 데몬 + CLI
cmake --build build --target liu-history  # 독립형 에이전트 기록 CLI
```

## 패키징 (macOS)

```
./scripts/build_macos_compat_deps.sh    # libssh2 + OpenSSL 포함
./scripts/package_macos_dmg.sh          # 서명된 .app + DMG
```

## 커스텀 Terminfo

Liu는 원격 셸이 올바른 기능을 알릴 수 있도록 자체 터미널 항목과 함께 제공됩니다 - 트루컬러, 마우스 모드, 괄호 붙여넣기, Mode 2026 동기화 출력, OSC 7/8/133.

```
tic -x liu.terminfo
```

[다음 빠른 시작 →](https://liu.software/ko/docs/quickstart.md)