PixelTerm-C は、画像・動画・電子書籍をターミナル内で閲覧するための C 製メディアブラウザです。 単体のファイルを開くことも、ディレクトリ内を移動しながらプレビューすることもでき、作業をターミナル内で完結できます。
- 画像、アニメーション GIF、動画、PDF/EPUB/CBZ を 1 つのワークフローで扱えます。
- 単体表示、グリッド表示、電子書籍ビューア、ファイルマネージャをキーボードでもマウスでも操作できます。
- 描画方式、プリロード、ディザリング、ガンマ補正などを設定でき、端末ごとに調整できます。
- 起動や切り替えが軽く、続けて見比べたい場面でも扱いやすくなっています。
PixelTerm-C の表示例です。
実際の実行画面を使ったスクリーンショットです。
macOS と Linux では、まず 1 コマンドのインストーラを使えます。
curl -fsSL https://raw.githubusercontent.com/zouyonghe/PixelTerm-C/main/scripts/install.sh | bashこのインストーラは macOS/Linux + amd64/arm64 を自動判定し、最新の GitHub Release バイナリを /usr/local/bin/pixelterm にインストールします。対象ディレクトリに書き込み権限がない場合だけ sudo を使います。
/usr/local/bin 以外に入れたい場合は、インストール先ディレクトリを指定できます。
curl -fsSL https://raw.githubusercontent.com/zouyonghe/PixelTerm-C/main/scripts/install.sh | bash -s -- --bin-dir "$HOME/.local/bin"再現性のあるインストールが必要な場合は、release tag を固定できます。
curl -fsSL https://raw.githubusercontent.com/zouyonghe/PixelTerm-C/main/scripts/install.sh | bash -s -- --version v1.7.26パッケージマネージャや手動インストールを使いたい場合は、以下の方法も利用できます。
# Arch Linux
paru -S pixelterm-c
# または
yay -S pixelterm-c# Linux AMD64
wget https://github.com/zouyonghe/PixelTerm-C/releases/latest/download/pixelterm-amd64-linux
chmod +x pixelterm-amd64-linux && sudo mv pixelterm-amd64-linux /usr/local/bin/pixelterm
# Linux ARM64
wget https://github.com/zouyonghe/PixelTerm-C/releases/latest/download/pixelterm-arm64-linux
chmod +x pixelterm-arm64-linux && sudo mv pixelterm-arm64-linux /usr/local/bin/pixelterm
# macOS AMD64
wget https://github.com/zouyonghe/PixelTerm-C/releases/latest/download/pixelterm-amd64-macos
chmod +x pixelterm-amd64-macos && sudo mv pixelterm-amd64-macos /usr/local/bin/pixelterm
# macOS ARM64 (Apple Silicon)
wget https://github.com/zouyonghe/PixelTerm-C/releases/latest/download/pixelterm-arm64-macos
chmod +x pixelterm-arm64-macos && sudo mv pixelterm-arm64-macos /usr/local/bin/pixeltermmacOS でセキュリティ制限により起動できない場合は、必要に応じて次を実行してください。
xattr -dr com.apple.quarantine /usr/local/bin/pixelterm# 画像を開く
pixelterm /path/to/image.jpg
# 動画を再生する（音声なし）
pixelterm /path/to/video.mp4
# 電子書籍を読む（PDF/EPUB/CBZ）
pixelterm /path/to/book.pdf
# ディレクトリをブラウズする
pixelterm /path/to/directory
# CLI ヘルプを表示する
pixelterm --helpCLI オプションや追加の例は USAGE_ja.md を参照してください。
- 画像: JPG, PNG, GIF, BMP, WebP, TIFF など
- 動画: MP4, MKV, AVI, MOV, WebM, MPEG/MPG, M4V（映像のみ）
- 電子書籍: PDF, EPUB, CBZ（MuPDF 対応でビルドされた場合）
- 出力プロトコルは通常
autoで自動判定され、必要に応じて--protocolでtext、sixel、kitty、iterm2を指定できます。
端末ごとの挙動やプロトコルについては TERMINAL_PROTOCOL_SUPPORT_ja.md にまとめています。
PixelTerm-C は $XDG_CONFIG_HOME/pixelterm/config.ini を読み込み、XDG_CONFIG_HOME が未設定または空の場合は $HOME/.config/pixelterm/config.ini にフォールバックします。--config を使うと別の設定ファイルも指定できます。まずは config.example.ini をベースに、共通設定を [default] に置き、TERM_PROGRAM、LC_TERMINAL、TERMINAL_NAME、TERM に対応するセクションで端末ごとの上書きを設定してください。コマンドライン引数は設定ファイルの読み込み後に解釈されるため、明示的に指定した CLI オプションが設定値を上書きします。
テキスト出力を使う場合は、--text-symbols auto|half|quarter または text_symbols = auto|half|quarter で、端末安全な既定の記号集合を維持するか、より強い half-block / quarter-block の手動記号集合へ切り替えられます。
mkdir -p ~/.config/pixelterm
cp config.example.ini ~/.config/pixelterm/config.ini- README.md
- USAGE_ja.md
- CONTROLS_ja.md
- TROUBLESHOOTING_ja.md
- CHANGELOG.md
- TERMINAL_PROTOCOL_SUPPORT_ja.md
# Ubuntu/Debian
sudo apt-get install libchafa-dev libglib2.0-dev libgdk-pixbuf2.0-dev libavformat-dev libavcodec-dev libswscale-dev libavutil-dev pkg-config build-essential
# 電子書籍対応を有効にする場合
sudo apt-get install libmupdf-dev
# Arch Linux
sudo pacman -S chafa glib2 gdk-pixbuf2 ffmpeg pkgconf base-devel
# 電子書籍対応を有効にする場合
sudo pacman -S mupdfmacOS でソースからビルドする場合は、Homebrew で同等の依存関係を用意してください。
brew install chafa glib gdk-pixbuf ffmpeg pkg-config
# 電子書籍対応を有効にする場合
brew install mupdfgit clone https://github.com/zouyonghe/PixelTerm-C.git
cd PixelTerm-C
make
# 生成物: bin/pixelterm
# システムへインストールする場合: sudo make install
# aarch64 向けクロスコンパイル
make CC=aarch64-linux-gnu-gcc ARCH=aarch64MuPDF が見つからない環境では、電子書籍機能なしでビルドされます。クロスコンパイルは実験的な扱いで、対象アーキテクチャ向けの依存ライブラリが別途必要です。
LGPL-3.0 以降。詳細は LICENSE を参照してください。
このプロジェクトは Chafa と同じ LGPLv3+ で配布されています。