yaziとは？使い方とキー早見表｜ターミナルのファイルマネージャー

ターミナルでの作業は ls と cd の繰り返しになりがちです。yazi は、その「見る・移動する・選ぶ」を1つの画面にまとめる道具です。画面は3列で、左が1つ上のフォルダー、真ん中が今いるフォルダー、右がカーソルの当たっているファイルの中身です。名前は中国語で「アヒル」を意味します（公式 README）。

flowchart TD
    A[yazi で起動] --> B[hjkl で移動]
    B --> C[右の列で中身を見る]
    C --> D[Space で選ぶ]
    D --> E[y x p / d / r]
    E --> F[q で終了]

よく調べられることの答えを先にまとめます。

確認環境：Ubuntu 24.04.5 LTS（2 CPU・メモリ 8GB）。yazi 本体は、crates.io の yazi-fm・yazi-cli 26.5.6 を cargo 1.97.0 でビルドしようとしましたが、依存の取得だけで作業場所の上限（300MB）を超えたため止め、その計測値を載せています。PyPI の非公式パッケージ yazi-bin 26.9.1 は取得と中身の確認までで、この環境では実行の許可が得られず起動していません。GitHub のリリース一覧も取得できませんでした。そのためキー割り当てと設定は、取得したソースの既定設定ファイル（keymap-default.toml・yazi-default.toml）とプレビュー用 Lua プラグインの実物から読み取り、yazi が裏で呼ぶコマンド（file 5.45・jq 1.7・pdftoppm 24.02.0・ffmpeg 6.1.1・ImageMagick 6.9.12-98）は同じ引数で実行しました。tmux 3.4 は作業用のソケットで起動し、ranger 1.9.3・nnn 4.9・lf 31 は Ubuntu の .deb を作業場所に展開して確かめています。画面の見え方・インストールのコマンド・画像表示の対応端末は公式ドキュメント（yazi-rs.github.io）で確かめた範囲です（確認日 2026年10月29日）。

yaziとは（ターミナルで動くファイルマネージャー）

この節では、yazi が何をする道具で、どんな部品からできているのかが分かります。

yazi は、ターミナルの中でエクスプローラーや Finder の役をする TUI（文字で描く画面）のアプリです。マウスでも操作できますが、基本は Vim に似たキー（h・j・k・l）で動かします。公式は「非同期 I/O に基づく、速いターミナルのファイルマネージャー」と説明していて、ファイル一覧の読み込みやプレビュー作りを裏で進めるため、読み込み中でもカーソルを動かせます。

入れると、コマンドが2つ使えるようになります。

ソースの args.rs では、yazi の引数は開く場所（最大9つ）・--cwd-file・--chooser-file・--clear-cache・--debug など、ya のサブコマンドは emit・emit-to・exec・pkg・pub・pub-to・sub の7つでした。

できることと、裏で使う外部のコマンドです。外部のコマンドが無くても起動はしますが、その機能だけが使えません。

2026年10月29日時点で、公式ドキュメントは 26.9.1 が対象、crates.io の yazi-fm・yazi-cli は 26.5.6 でした。この記事のキー割り当ては 26.5.6 の既定ファイルから読んでいます。

最初の5分：yaziを入れて起動・終了するまで

この節では、yazi を入れてから、起動・移動・終了までの最短の流れが分かります。

最初は「入れる → 起動 → hjkl で動く → q で終わる」の4つだけ覚えます。コピーや検索は、そのあとで足していけば困りません。

右の列には、フォルダーならその中身の一覧、テキストなら色付きの本文、画像は対応した端末なら画像そのものが出ます。迷ったら F1 で今使えるキーの一覧を開きます。

yaziのインストール方法（Mac・Windows・Linux）

この節では、OS ごとの yazi の入れ方と、ソースからビルドするときにかかる容量が分かります。

まずは OS のパッケージマネージャーで入れるのが早道です。公式のインストールページには20通り以上の方法が載っています。よく使われるものを抜き出しました（コマンドは公式ページのとおり）。

Ubuntu 24.04 の標準リポジトリで、yazi と比較相手のファイルマネージャーを引いた結果です。yazi だけ候補が出ません。

$ for p in yazi ranger nnn lf; do printf "%-8s" $p; apt-cache policy $p | grep Candidate; echo; done
yazi
ranger    Candidate: 1.9.3-5ubuntu0.24.04.1
nnn       Candidate: 4.9-1build2
lf        Candidate: 31+ds-1ubuntu0.24.04.3

Ubuntu では、公式の APT リポジトリを追加するか、snap、公式バイナリ（GitHub Releases の GNU 版・musl 版）を使います。PyPI には非公式の yazi-bin もあり、公式のインストールページに pipx install yazi-bin・uv tool install yazi-bin が載っています。取得して中身を見ると、wheel は 16.1MB で、展開すると yazi と ya の2つの実行ファイル（合わせて 37MB）が入っていました。

Windows で入れるときの注意

Windows には、ファイルの種類を判定する file コマンドがありません。公式は、Git for Windows に入っている file.exe を使う方法を勧めていて、YAZI_FILE_ONE 環境変数に Git\usr\bin\file.exe の場所を設定し、ターミナルを開き直します。公式ページは、file を Scoop や Chocolatey で入れることは勧めていません。

ソースからビルドする場合にかかる容量（実測）

ソースからのビルドは、取得だけで 350MB を超えました。2 CPU に合わせて -j2 で cargo install --locked yazi-fm yazi-cli を始めたところ、5秒で 186MB、10秒で 355MB になり、上限に当たったため止めました。

$ cargo install --locked -j2 --root /dev/shm/t188/inst yazi-fm yazi-cli
    Updating crates.io index
 Downloading crates ...
  Downloaded ref-cast v1.0.25
  Downloaded schemars v1.2.1
  ...
  Downloaded yazi-runner v26.5.6
   Compiling proc-macro2 v1.0.106
   Compiling quote v1.0.45
   Compiling libc v0.2.186
   Compiling syn v2.0.117
（作業場所の上限に当たったため、ここで停止）

$ grep -c Downloaded build.log
522
$ du -sm cargo
351	cargo

このあとにコンパイルの成果物が加わるので、小さなマシンやディスクの少ない環境では、パッケージかバイナリを使うほうが確実です。Rust が 1.95 より前だとビルドは止まります。

yaziの依存ツールとUbuntu 24.04での注意

この節では、yazi が使う外部ツールと、Ubuntu 24.04 の標準パッケージで条件を満たせるかが分かります。

Ubuntu 24.04 の標準パッケージだけでは、fzf・chafa・ImageMagick の3つが公式の最低版に届きません。公式のインストールページの依存一覧と、Ubuntu 24.04 で apt-cache と .deb の中身を調べた結果を並べます。

fd は、Debian・Ubuntu では別の同名コマンドとぶつかるため、fdfind という名前で入ります。.deb の中身と、展開した fd の表示です。

$ dpkg -c fd-find_9.0.0-1_amd64.deb | grep bin/
-rwxr-xr-x root/root   3406248 2023-12-31 04:41 ./usr/lib/cargo/bin/fd
lrwxrwxrwx root/root         0 2023-12-31 04:41 ./usr/bin/fdfind -> ../lib/cargo/bin/fd
$ ./usr/lib/cargo/bin/fd --version
fdfind 9.0.0
$ ./usr/bin/fzf --version
0.44.1 (debian)

yazi の s は fd という名前のコマンドを呼ぶので、Ubuntu では PATH の通った場所に fd という名前のリンクを作ります。

mkdir -p ~/.local/bin
ln -s "$(command -v fdfind)" ~/.local/bin/fd

fzf は 0.53.0 未満だと z が正しく動かないため、新しい版を別に入れます。ImageMagick 6.9 系には magick コマンドが無く、フォント・HEIC・JPEG XL のプレビューは動きません（PNG・JPEG は yazi 本体が描くので影響しません）。

yaziの画面の見方とキー操作早見表

この節では、yazi の画面の3列の意味と、既定のキー割り当てのうちよく使うものが分かります。

既定のキー割り当ては、ファイル一覧の画面（mgr）だけで110個あります。既定ファイル keymap-default.toml を Python の tomllib で読み、画面（層）ごとに数えた結果です。

$ python3 check_conf.py conf
== 既定のキー割り当ての数
mgr      110
tasks    12
spot     15
pick     10
input    62
confirm  12
cmp      11
help     8

mgr はファイル一覧、tasks はタスク管理（w）、spot はファイル情報（Tab）、pick は「開くアプリを選ぶ」画面、input は名前の入力欄、confirm は確認の画面、cmp は入力の補完、help はヘルプの画面です。yazi.toml の ratio = [ 1, 4, 3 ] が、左（親フォルダー）・真ん中（今のフォルダー）・右（プレビュー）の幅の比です。

移動と選択

ファイル操作

検索・表示・タブ

並べ替えの「自然順」は、数字を数として比べる並べ方です。ファイル名の文字順（, a）と自然順（, n）の違いを、sort と sort -V で同じファイル名に当てると次のようになります。写真の連番を並べるときは自然順が便利です。

$ ls photos | sort        # 文字順
IMG_1.jpg
IMG_10.jpg
IMG_11.jpg
IMG_2.jpg
$ ls photos | sort -V     # 自然順
IMG_1.jpg
IMG_2.jpg
IMG_10.jpg
IMG_11.jpg

覚える順番は、次のとおりにすると迷いません。

1. 1hjkl・Enter・q移動と開く・終わる。矢印キーでもよい
2. 2Space・y・x・p・d選んでコピー・移動・ゴミ箱へ
3. 3a・r・.作る・名前を変える・隠しファイル
4. 4/・f・s・S探す・絞り込む・下の階層まで検索
5. 5g の組み合わせ・z・Zよく行く場所へ一気に飛ぶ
6. 6t t・1〜9・wタブと、重いコピーの進み具合

終了したフォルダーへ移動する（シェルラッパー y）

この節では、yazi を閉じたあと、シェルの場所を yazi で最後にいたフォルダーに合わせる方法と、その仕組みが分かります。

yazi を yazi で起動して q で閉じても、シェルの場所は変わりません。yazi はシェルから起動された別のプロセスで、別のプロセスからは親のシェルの場所（カレントディレクトリ）を変えられないためです。そこで公式は、終了時の場所をファイルに書き出させ、シェルの関数がそれを読んで cd する「シェルラッパー」を用意しています。bash・zsh 用は次のとおりです。

function y() {
	local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd
	command yazi "$@" --cwd-file="$tmp"
	IFS= read -r -d '' cwd < "$tmp"
	[ "$cwd" != "$PWD" ] && [ -d "$cwd" ] && builtin cd -- "$cwd"
	rm -f -- "$tmp"
}

これを ~/.bashrc か ~/.zshrc に書き、シェルを開き直して y で起動します。fish・Nushell・PowerShell・コマンドプロンプト用の書き方も公式のクイックスタートにあります。.bashrc への書き方と読み込みは、関連記事「Linux alias設定と.bashrcの書き方｜おすすめエイリアス50選」で扱っています。

yazi の代わりに「--cwd-file に行き先を書いて終わるだけ」の確認用スクリプトを PATH の先頭に置き、q と Q を再現しました。

$ source wrap.sh; cd /dev/shm/t188
$ echo "before: $PWD"; STUB_KEY=q y demo; echo "after q: $PWD"
before: /dev/shm/t188
[stub] args: demo --cwd-file=/dev/shm/t188/yazi-cwd.ITKRPo
after q: /dev/shm/t188/demo/photos
$ cd /dev/shm/t188; STUB_KEY=Q y demo; echo "after Q: $PWD"
[stub] args: demo --cwd-file=/dev/shm/t188/yazi-cwd.pyBymV
after Q: /dev/shm/t188

# 関数を通さずに起動した場合（ファイルには書かれるが、シェルは動かない）
$ STUB_KEY=q yazi demo --cwd-file=cwd.txt; echo "pwd: $PWD"; cat cwd.txt
pwd: /dev/shm/t188
/dev/shm/t188/demo/photos

q では書き出された場所へ移り、Q では --no-cwd-file の扱いでファイルが空のままなので、元の場所に残りました。一時ファイルが残らないことも確かめました。

yaziのプレビューの仕組み（画像・PDF・動画・JSON）

この節では、yazi がファイルの種類を見分けてプレビューを作る流れと、裏で呼ぶコマンドの実際の速さが分かります。

yazi は、まず file コマンドで MIME タイプ（ファイルの種類の名前）を調べ、yazi.toml の previewers の規則に当てて、使うプラグインを決めます。既定ファイルとプラグインの Lua ソースから読み取った流れです。

flowchart TD
    A[カーソルが当たる] --> B[file -bL --mime-type]
    B --> C[x- と vnd. を外す]
    C --> D{previewers の規則}
    D -->|text| E[内蔵の code]
    D -->|pdf| F[pdftoppm]
    D -->|video| G[ffmpeg]

種類の判定は、プラグイン mime-local.lua が file -bL --mime-type -- パス… を実行して行います。同じコマンドを、自作の見本ファイルに当てた結果です。10ファイルで 0.009 秒でした。

$ file -bL --mime-type -- arc.zip clip.mp4 data.json doc.pdf empty.txt icon.svg img.png note.txt photos run.sh
arc.zip    application/zip
clip.mp4   video/mp4
data.json  application/json
doc.pdf    application/pdf
empty.txt  inode/x-empty
icon.svg   image/svg+xml
img.png    image/png
note.txt   text/plain
photos     inode/directory
run.sh     text/x-shellscript

mime-local.lua は、結果の先頭の x- と vnd. を取り除いてから規則に当てます。そのため inode/x-empty は既定の規則の inode/empty（空のファイル）に、text/x-shellscript は text/*（コードとして色付き表示）に当たります。自分で規則を書くときは、この取り除いたあとの名前で書きます。

プレビューを作るプラグインは、決まった引数で外部のコマンドを呼びます。pdf.lua・video.lua・json.lua に書かれている引数のまま実行し、時間を測りました。

動画の縮小の上限は yazi.toml の max_width = 600・max_height = 900、画質は image_quality = 75 から決まります（ffmpeg の -q:v は 31 - floor(75 × 0.3) で 9）。GPU の無いこの環境では、ffmpeg の -hwaccel auto が次の警告を出しましたが、サムネイルは作られました。

[AVHWDeviceContext @ 0x5582d51324c0] Cannot load libcuda.so.1
[AVHWDeviceContext @ 0x5582d51324c0] Could not dynamically load CUDA
[AVHWDeviceContext @ 0x5582d5131240] Instance creation failure: VK_ERROR_INCOMPATIBLE_DRIVER
$ file vid.jpg
vid.jpg: JPEG image data, JFIF standard 1.02, ..., baseline, precision 8, 600x338, components 3

作ったプレビューはキャッシュに保存され、2回目から速く出ます。表示がおかしいときは yazi --clear-cache で消します。

yaziで画像が表示されないとき（端末の対応とtmux）

この節では、画像のプレビューが出る端末・出ない端末の違いと、tmux の中で画像を出す設定が分かります。

画像のプレビューは、端末が画像を描く仕組み（プロトコル）に対応しているかで決まります。yazi は $TERM・$TERM_PROGRAM・$XDG_SESSION_TYPE などから端末を見分けて、使う仕組みを自動で選びます。公式ページの対応表の主なものです。

ソースの adapters.rs でも、端末ごとに使う仕組みが決められていて、tmux・Apple のターミナル.app・urxvt には何も割り当てられていません。当たる仕組みが無いと、X11・Wayland（Überzug++）、最後に Chafa の順に下がります。GNOME 端末のような VTE 系の端末も、画像の仕組みを持たないため、Überzug++ か Chafa が無いと画像の欄は空になります。

tmux の中で画像を出す設定

tmux は、間に入って端末への命令を自分で解釈するため、画像の命令がそのままでは外の端末に届きません。公式は tmux.conf に次の3行を書き、tmux を再起動するよう案内しています。

set -g allow-passthrough on
set -ga update-environment TERM
set -ga update-environment TERM_PROGRAM

tmux 3.4 を作業用のソケットで起動して確かめると、既定は off で、3行を読み込むと on になり、TERM と TERM_PROGRAM が足されました。yazi のソース（mux.rs）が tmux の中で実行する tmux set -p allow-passthrough on も成功しました。

$ tmux -L t188 -f /dev/null new-session -d -s t188
$ tmux -L t188 show -gv allow-passthrough
off
$ tmux -L t188 set -p -t t188 allow-passthrough on; echo "exit=$?"
exit=0
$ tmux -L t188 source-file tmux-yazi.conf
$ tmux -L t188 show -g allow-passthrough
allow-passthrough on
$ tmux -L t188 show -g update-environment | tail -3
update-environment[7] XAUTHORITY
update-environment[8] TERM
update-environment[9] TERM_PROGRAM
$ tmux -L t188 display -p "#{sixel_support}"

#{sixel_support} は yazi が tmux の Sixel 対応を調べるときに使う値で、Ubuntu の tmux 3.4 では何も返りませんでした。公式ページによると、tmux で Sixel を使うには --enable-sixel を付けてビルドされた tmux が要ります。kitty・Ghostty など Sixel 以外の仕組みの端末なら、passthrough だけで画像が出ます。tmux の基本の使い方と .tmux.conf の書き方は、関連記事「tmuxの使い方｜キーバインド早見表とコピペ用.tmux.conf」で扱っています。

Zellij の中では Kitty old protocol と Sixel しか使えず、公式は画像が大事なら Zellij の外で使うよう勧めています。Neovim の :terminal の中も画像の仕組みを持ちません。

yaziのファイル操作・検索・一括リネーム

この節では、コピー・移動・削除・作成と、検索、複数ファイルの名前をエディターでまとめて変える一括リネームの流れが分かります。

yazi のファイル操作は「選ぶ → 印を付ける → 貼る」の順です。Space で選んで y か x、移動先で p。選んでいなければカーソルのファイルが対象です。重いコピーは裏で進み、w で進み具合を見られます。

削除は2種類あり、確認の画面の文言は既定ファイルでは次のとおりです。

コマンドで同じ操作をするときの cp・mv・rm のオプションは、関連記事「cp・rm・mvコマンドの使い方｜オプション早見表とエラーの直し方」で扱っています。

検索の4つの方法

/ は今のフォルダーで一致へカーソルを動かすだけ、f は一覧を一致したものだけに絞ります。s は fd で下の階層まで名前を、S は ripgrep で中身を探して一覧にします（Ctrl+s で中止）。条件を細かく組む・見つけたものにまとめて処理するなら、シェルの find が向いています。関連記事「findコマンドの使い方｜目的別逆引き40例と-exec・xargsの違い」で扱っています。

一括リネームの流れ

複数のファイルを選んで r を押すと、名前の一覧がテキストエディターで開き、書き換えて保存すると、その名前に変わります。ソース（bulk_rename.rs）から読み取った流れは次のとおりです。

• 選んだファイルの名前を1行ずつ一時ファイルに書き、yazi.toml の opener の edit（既定は ${EDITOR:-vi}）で開く
• 保存して閉じると、行の数が元と同じかを確かめる。違えば何もしない
• 変えていない行は除き、「元の名前 -> 新しい名前」の一覧を出して Continue to rename? (y/N) と聞く
• 行き先に同名のファイルがあるものは変えず、最後に失敗の一覧を出す

この判定を写した確認用スクリプトで、写真4枚の名前を sed で書き換えた場合と、うっかり1行消した場合、同名にしてしまった場合を試しました。表示の文言は yazi のソースのままです。

$ cat bulk.txt                       # yazi がエディターで開くのと同じ形
IMG_1.jpg
IMG_2.jpg
IMG_10.jpg
IMG_11.jpg
$ sed -E 's/IMG_([0-9]+)\.jpg/printf "2026-10_%02d.jpg" \1/e' bulk.txt > bulk_new.txt
$ python3 bulk_check.py bulk.txt bulk_new.txt
IMG_1.jpg -> 2026-10_01.jpg
IMG_2.jpg -> 2026-10_02.jpg
IMG_10.jpg -> 2026-10_10.jpg
IMG_11.jpg -> 2026-10_11.jpg
Continue to rename? (y/N):

$ python3 bulk_check.py bulk.txt bulk_short.txt     # 1行消した
Number of new and old file names mismatch (New: 3, Old: 4).
Press <Enter> to exit...

$ python3 bulk_check.py bulk.txt bulk_dup.txt       # 既にある名前にした
IMG_2.jpg -> IMG_10.jpg
Continue to rename? (y/N):
Failed: IMG_2.jpg -> IMG_10.jpg: Destination already exists

Vim なら :%s/IMG_/photo_/ のような置換で一気に書き換えられます。行を並べ替えると、ほかのファイルの名前と入れ替わるので、行の順番は変えないのが安全です。エディターが見つからないときは Bulk rename: No text opener found という通知が出ます（ソースの文言）。

yaziの設定ファイル（yazi.toml・keymap.toml・theme.toml）

この節では、設定ファイルの場所と、既定の設定を壊さずに一部だけ変える書き方、キーの割り当てがぶつかっていないかの確かめ方が分かります。

設定ファイルは3つで、どれも「変えたいところだけ」を書けば既定の値に上書きされます。公式の説明では、既定ファイルを丸ごとコピーせず、必要な部分だけ写します。

環境変数 YAZI_CONFIG_HOME を設定すると、別の場所の設定で起動できます（例：YAZI_CONFIG_HOME=~/.config/yazi-alt yazi）。設定を試すときに、ふだんの設定を残したまま確かめられます。

yazi.toml の例と打ち間違いの確かめ方

隠しファイルを表示し、自然順で並べ、行の右に大きさを出し、テキストを Neovim で開く例です。わざと show_hidden を show_hiden と打ち間違えています。

[mgr]
ratio          = [ 1, 3, 4 ]
sort_by        = "natural"
sort_dir_first = true
linemode       = "size"
show_hiden     = true

[preview]
max_width  = 1000
max_height = 1000

[opener]
edit = [
	{ run = 'nvim %s', desc = "nvim", block = true, for = "unix" },
]

既定ファイルの項目名と突き合わせる小さなスクリプト（tomllib を使う Python、0.039秒）で確かめると、打ち間違いが見つかりました。

== yazi.toml の確認
  [mgr] show_hiden: 既定ファイルに無い項目（打ち間違い？）

既定ファイルにある項目名は、公式の設定ページか、yazi のソースの yazi-config/preset/yazi-default.toml で確かめられます。既定ファイル（26.5.6）では、ファイル一覧の節の名前は [mgr] です。以前の版向けに書かれた設定例を写すときは、節の名前と項目名が手元の版の既定ファイルと同じかを先に見ます。テキストを開くエディターの設定は、Neovim の初期設定とあわせて見直すと迷いません。Neovim そのものの入れ方と init.lua は、関連記事「Neovimとは｜インストール・init.lua設定・lazy.nvim・LSP入門」で扱っています。

keymap.toml は prepend_keymap で足す

keymap.toml に keymap = [ ... ] と書くと、既定の割り当てがすべて置き換わります。既定を残したまま足すときは、prepend_keymap（既定より先に当てる）か append_keymap（既定より後に当てる）を使います。

[[mgr.prepend_keymap]]
on   = [ "g", "r" ]
run  = 'shell -- ya emit cd "$(git rev-parse --show-toplevel)"'
desc = "Git のルートへ移動"

[[mgr.prepend_keymap]]
on   = "!"
run  = 'shell "$SHELL" --block'
desc = "ここでシェルを開く"

[[mgr.prepend_keymap]]
on   = [ "g", "d" ]
run  = "cd ~/work"
desc = "~/work へ移動"

同じスクリプトで既定の割り当てと突き合わせると、g d が既定の「~/Downloads へ移動」を上書きすることが分かりました。知らずにぶつけると既定の動きが消えます。

== mgr で1文字のキーに割り当てが無いもの: beiuABCEFIMRTUW0!@#$%^&*()=+\|'"<>
== 2打鍵の先頭キー: , c g m t
== keymap.toml の確認
  'g r': 空いているキー
  '!': 空いているキー
  'g d': 既定の「Go ~/Downloads」(cd ~/Downloads) より先に当たる＝上書き

ファイル一覧の画面で1文字のキーとして空いているのは、小文字では b・e・i・u、大文字では A・B・C・E・F・I・M・R・T・U・W などでした。,・c・g・m・t は2打鍵の先頭に使われているため、1文字のキーとしては割り当てられません。

色は theme.toml で変えます。公式の配色の一式「フレーバー（flavor）」から端末に合うものを入れると、文字の色が見分けにくい問題が直ります。

yaziのプラグインとテーマ（ya pkg・init.lua）

この節では、プラグインの入れ方・管理の仕方と、ログの見方が分かります。

プラグインとフレーバーは ya pkg で入れます。公式の CLI ページのコマンドです。

ya pkg add yazi-rs/plugins:git     # 公式プラグイン集から git を入れる
ya pkg add owner/my-plugin         # GitHub の owner/リポジトリ名で入れる
ya pkg list                        # 入れたものの一覧
ya pkg upgrade                     # まとめて更新
ya pkg install                     # package.toml のとおりに入れ直す
ya pkg delete yazi-rs/plugins:git  # 消す

入れたものは ~/.config/yazi/package.toml に、名前・リビジョン（rev）・ハッシュの組で記録されます。rev の頭に = を付けると、その版に固定され、ya pkg upgrade で更新されません。設定フォルダーを Git で管理しておけば、別のマシンでも ya pkg install で同じプラグインがそろいます。

プラグインの本体は ~/.config/yazi/plugins/ に、名前.yazi というフォルダー（入口は main.lua）として置かれます。プラグインの設定は init.lua に Lua で書きます。以前の解説では ya pack というコマンドが使われていますが、26.5.6 の ya のサブコマンドは pkg で、pack はありませんでした。

公式プラグイン集（yazi-rs/plugins）には、Git の状態を出す git、枠線の full-border、Enter で入る・開くを1つにする smart-enter などがあります。Neovim の中から yazi を呼ぶ yazi.nvim もあります。

思いどおりに動かないときは YAZI_LOG=debug yazi で起動すると、~/.local/state/yazi/yazi.log（Windows は %AppData%\yazi\state\yazi.log）にログが残ります。yazi --debug はデバッグ情報を表示します。

ranger・lf・nnnとの比較と選び方

この節では、ほかのターミナルのファイルマネージャーとの違いと、どれを選ぶかの目安が分かります。

yazi・ranger・lf・nnn は、どれも3列か2列のキーボード操作のファイルマネージャーで、違いは作りと設定の方法、軽さです。言語と設定の方法は各公式の説明、版と大きさは Ubuntu 24.04 のパッケージで確かめた値です。

ranger は Python で動くので、Python の版の影響を受けます。Ubuntu 24.04 の ranger 1.9.3 を展開し、この環境の Python 3.13 で起動すると、Python 3.13 で取り除かれた標準モジュール imghdr を読み込もうとして止まりました。Ubuntu 標準の Python 3.12 では起動しています。

$ python3 --version
Python 3.13.18
$ PYTHONPATH=usr/lib/python3/dist-packages python3 usr/bin/ranger --version
  File ".../ranger/ext/img_display.py", line 18, in <module>
    import imghdr
ModuleNotFoundError: No module named 'imghdr'
$ PYTHONPATH=usr/lib/python3/dist-packages /usr/bin/python3.12 usr/bin/ranger --version
ranger version: ranger 1.9.3
Python version: 3.12.3
$ ./usr/bin/nnn -V
4.9
$ ./usr/bin/lf -version
31+ds

yazi・lf・nnn は1つの実行ファイルで、Python の版に左右されません。目的別の目安です。

入れる前に、次の点を確かめておくと、つまずきが減ります。

• 1file コマンドがあるかWindows は Git for Windows の file.exe を YAZI_FILE_ONE で指定
• 2端末が画像の仕組みに対応しているかkitty・Ghostty・WezTerm・iTerm2・Windows Terminal など
• 3Nerd Font を入れたか無いとアイコンが四角や記号になる
• 4fzf が 0.53.0 以上かUbuntu 24.04 の標準は 0.44.1
• 5fd という名前で呼べるかUbuntu は fdfind。リンクを作る
• 6シェルラッパー y を入れたか終了したフォルダーへ移るのに要る
• 7EDITOR を設定したかテキストを開く・一括リネームで使う

yaziのよくあるエラー・つまずき

この節では、yazi でよく出る症状と、その原因・直し方が分かります。

yazi のつまずきの多くは、yazi 本体ではなく、端末か外部のツールの側にあります。エラーの文言は、公式の FAQ と、yazi のソース・プラグインに書かれているものです。

起動時の応答待ちのエラーは、公式 FAQ によると、ほかに問題が無ければ無視してよいものです。tmux なら更新・passthrough の有効化・設定を1つずつ戻す順で原因を探します。

よくある質問

この節では、yazi についてよく聞かれることへの答えが分かります。

Q. yazi は無料ですか？ A. 無料で使えるオープンソースのソフトウェアです。PyPI の yazi-bin に同梱されたライセンスは MIT でした。

Q. Windows でも使えますか？ A. 使えます。WinGet か Scoop で入れ、Git for Windows の file.exe を YAZI_FILE_ONE で指定します。画像のプレビューは Windows Terminal v1.22.10352.0 以降などで出ます。

Q. 隠しファイルを最初から表示するには？ A. yazi.toml の [mgr] に show_hidden = true と書きます。その場で切り替えるだけなら . キーです。

Q. Enter でフォルダーにも入れるようにしたい A. 既定でも Enter はフォルダーを開きますが、公式 FAQ によると「開く」と「入る」はわざと分けています。1つにしたいときは公式プラグイン smart-enter を使います。

Q. ゴミ箱に入れたファイルはどこにありますか？ A. OS のゴミ箱です。Linux ではデスクトップのゴミ箱と同じ場所に入ります。26.9.1 の公式ドキュメントでは g t でゴミ箱のフォルダーへ移れます。D で消したものはゴミ箱に入りません。

Q. SSH 先のサーバーでも使えますか？ A. サーバーに yazi を入れて SSH の中で起動すれば使えます。画像のプレビューは端末と回線の遅延の影響を受けます。26.5.6 のソースには SFTP を扱う部品（yazi-sftp）も入っていました。

Q. 設定を初期状態に戻すには？ A. ~/.config/yazi/ の yazi.toml・keymap.toml・theme.toml を別の名前にするか消すと、既定の設定で起動します。YAZI_CONFIG_HOME に空のフォルダーを指定して試す方法もあります。

Q. ranger から乗り換えると何が変わりますか？ A. hjkl などの移動は似ていますが、コピーが yy でなく y、削除が d（ゴミ箱）と D（完全）というように1打鍵の操作が多くなります。設定は rc.conf ではなく TOML で書きます。

まとめ

• yazi は Rust 製のターミナル用ファイルマネージャー。コマンドは本体の yazi と、プラグイン管理などの ya の2つ。
• 入れ方は brew・winget・snap・各ディストリのパッケージ。ソースからのビルドは取得だけで 522 クレート・351MB で、小さなマシンではバイナリかパッケージが確実。
• 既定のキーはファイル一覧だけで110個。まずは hjkl・Enter・q、次に Space・y・x・p・d の順に覚え、終了後の移動はシェルラッパー y で。
• プレビューは file で種類を判定して jq・pdftoppm・ffmpeg などを呼ぶ。Ubuntu 24.04 の標準では fzf・chafa・ImageMagick が最低版に届かず、fd は fdfind という名前。
• 設定は変えたいところだけ書き、キーは prepend_keymap で足す。画像が出ないときは端末の対応と tmux の allow-passthrough を確かめる。

参考・出典

確認日はいずれも 2026年10月29日です。

• Yazi 公式ドキュメント「Installation」：https://yazi-rs.github.io/docs/installation/
• Yazi 公式ドキュメント「Quick Start」：https://yazi-rs.github.io/docs/quick-start
• Yazi 公式ドキュメント「Configuration」：https://yazi-rs.github.io/docs/configuration/overview
• Yazi 公式ドキュメント「Image Preview」：https://yazi-rs.github.io/docs/image-preview
• Yazi 公式ドキュメント「FAQ」：https://yazi-rs.github.io/docs/faq
• Yazi 公式ドキュメント「CLI」：https://yazi-rs.github.io/docs/cli
• Yazi 公式ドキュメント「Plugins」：https://yazi-rs.github.io/docs/plugins/overview
• Yazi のソースコード（GitHub）：https://github.com/sxyazi/yazi
• crates.io「yazi-fm」：https://crates.io/crates/yazi-fm
• PyPI「yazi-bin」：https://pypi.org/project/yazi-bin/
• tmux マニュアル：https://man7.org/linux/man-pages/man1/tmux.1.html
• yazi.nvim（GitHub）：https://github.com/mikavilpas/yazi.nvim

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。