# インストール — Liu Terminal

> macOSにLiu Terminalをインストール。Apple SiliconまたはIntel用DMGをダウンロードするか、Homebrewでインストールしてください。

URL: https://liu.software/ja/docs/install/  
Language: ja  
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
```

## 関連バイナリ

1回のトップレベルビルドで、メインアプリの隣に2つの兄弟バイナリが生成されます：

```
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/ja/docs/quickstart.md)