viu とは
viu は Rust で書かれた、小さいながら強力なコマンドライン画像ビューアです。画像をターミナルに直接表示します。ターミナルの能力に合わせて最適なプロトコルを選び、高忠実度の Kitty や iTerm2 のグラフィックプロトコルから、万能のフォールバックである Unicode ブロック文字まで使い分けます。
⚡ viu の主な機能
🖼️ 複数の画像表示プロトコル
Kitty のグラフィックプロトコル、iTerm2 のインライン画像、Sixel、Unicode ブロック文字に対応し、ターミナルに合わせて最適なものを自動で選びます。
📦 幅広いフォーマットに対応
Rust の image クレートを通じて、PNG、JPEG、GIF、BMP、ICO、TIFF、WebP、AVIF など多くの形式を表示します。
🎞️ GIF アニメーション
アニメーション GIF をターミナルで直接再生し、正しいフレームレートでループします。
📏 柔軟なサイズ指定
幅や高さを指定することも、ターミナルの大きさに自動で合わせることもできます。パイプラインやスクリプトで便利です。
🔗 パイプと相性がいい
標準入力からもファイル引数からも読めるので、curl や find、シェルのパイプラインと自然に組み合わせられます。
⚡ 速くて軽い
Rust 製で、起動時間は最小、メモリ消費も小さく、バイナリ以外の実行時依存はありません。
🖥️ 対応しているターミナルのプロトコル
- Kitty: フル解像度でドット単位まで正確な画像表示（kitty、Ghostty、WezTerm）
- iTerm2: インライン画像プロトコル（iTerm2、WezTerm、Tabby、VS Code）
- Sixel: foot、Windows Terminal、多くの古典的ターミナルに対応
- Unicode ブロック: どのターミナルでも動く万能のフォールバック
📦 deb.griffo.io からインストールする
ステップ 1: リポジトリを追加する
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 ずっと無料のミラーがあります。 deb-free.griffo.io は、アカウントもサブスクリプションもなしでパッケージをずっと無料で配布しています。上流より最大2か月遅れ、セキュリティ修正は即座に公開されます。現在収録しているのは cliamp、Ghostty、lazydocker、Oh My Posh と Zed です。viu は含まれていないため、今日入手する方法は上のリポジトリだけですが、ご要望があれば追加できます。
🧩 extrepo オプションについて。 extrepo は外部リポジトリを扱う Debian 標準のツールです。署名済みメタデータと照合して鍵を検証したうえで、sources ファイルの作成と署名鍵のインストールを代わりに行います。このリポジトリは griffo、ずっと無料のミラーは griffo-free という名前で登録されているので、Debian（bookworm、trixie、forky、sid）では上のコマンドだけで設定は完了です。
extrepo が用意するのは sources ファイルと鍵だけなので、サブスクリプションの認証情報は引き続き /etc/apt/auth.conf.d/deb.griffo.io.conf に書きます。extrepo は Debian のスイート向けメタデータしか公開していないため Ubuntu は対象外です。Ubuntu では sudo または root のコマンドを使ってください。
ステップ 2: viu をインストールする
# 最新の viu をインストール
sudo apt install viu
# インストールを確認
viu --version# 最新の viu をインストール
apt install viu
# インストールを確認
viu --version🎯 使い方の例
基本的な使い方:
# 画像を 1 枚表示
viu image.png
# 複数の画像を表示
viu *.jpg
# 標準入力から表示（ダウンロードした画像など）
curl -sL https://example.com/photo.jpg | viu -
# GIF アニメーションを表示
viu animation.gifサイズの指定:
# ターミナルの桁数で幅を指定
viu -w 80 image.png
# ターミナルの行数で高さを指定
viu -h 24 image.png
# 自動リサイズを無効化（元のサイズで）
viu -s image.pngパイプラインの例:
# ディレクトリ内の画像を順に見る
for f in ~/Pictures/*.jpg; do viu -w 40 "$f"; done
# URL の画像をプレビュー
curl -sL https://example.com/image.png | viu -
# fzf と組み合わせて閲覧・プレビュー
find . -name "*.png" | fzf --preview "viu -w 60 {}"🚀 deb.griffo.io を選ぶ理由
- 公式 Debian: viu は公式 Debian リポジトリにパッケージがありません
- cargo install: Rust ツールチェインとコンパイル時間が必要
- deb.griffo.io: 最新版を
aptですぐに
- ✅ 最新の機能: AVIF 対応やプロトコル改善を含む、viu の最新機能が手に入ります
- ✅ Rust のコンパイル不要: ビルド済みの musl 静的バイナリ。ツールチェインも追加の依存も要りません
- ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新
- ✅ まっとうなパッケージング: Debian パッケージとして正しく作られ、インストールも削除もきれいに済みます
- ✅ マルチディストリビューション: Bookworm、Trixie、Forky、Sid で動作
📦 パッケージのビルドリポジトリ
Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:
- 🖼️ viu-debian - 最新リリースのビルド
🔗 関連パッケージ
deb.griffo.io では、こちらも配布しています:
- Yazi ファイルマネージャ - 画像プレビューを内蔵したターミナルファイルマネージャ
- eza - モダンな ls の代替
- fzf ファジーファインダー - viu と組み合わせて、対話的に画像を閲覧