📘TUIファイルマネージャー『Yazi』がFinderを置き換える

[[📒Articles]] > [[📒2025 Articles]] ![[2025-09-14.webp|cover-picture]] [[Finder]]の代わりとなる[[TUI]]ファイルマネージャー『[[Yazi]]』について、導入の経緯とオススメ機能、プラグイン、ユースケース、カスタマイズ内容を紹介します。 ## はじめに 5月に[[macOS]]へと移行してから4ヶ月が経ちました。はじめのうちは[[Windows]]との違いに戸惑っていましたが、今では完全に[[Windows]]には戻れない身体となってしまいました。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" /> <span class="link-card-v2-site-name">Minerva</span> </div> <div class="link-card-v2-title"> 📘さよならWindows。33年の日々よ </div> <div class="link-card-v2-content">33年間使い続けたWindowsからmacOSへ移行した理由や経緯、実際の移行手順やおすすめツール、キーボードカスタマイズ、ターミナル、画像・動画圧縮、エディタ環境の違いなどを詳しく解説しています。WindowsとMacの違いや移行のコツを知りたい方はぜひご覧ください。</div> <img class="link-card-v2-image" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/%F0%9F%93%98Articles/attachments/2025-05-15.webp" /> <a data-href="📘さよならWindows。33年の日々よ" class="internal-link"></a> </div> %%[[📘さよならWindows。33年の日々よ]]%% そんな[[macOS]]ですが、今もなお不満点が1つあります。標準のファイルマネージャーである[[Finder]]です。 ### Finder 3つの不満 [[Finder]]を使い始めた頃は『[[Windows]]のファイルマネージャーよりオシャレでいいな』とか思っていました。しかし、1ヶ月以上使っていたら不満が3つ出てきました。 #### [[UTF-8-MAC]]問題これが[[Finder]]を使う上で **最も厄介な問題** です。[[Finder]]でファイル名を編集すると、[[UTF-8-MAC]]として保存されてしまうため、濁点を含む一部文字列が他で編集した場合と異なる文字列になってしまいます。具体的な問題としては、**[[Finder]]で `ガーベージ.md` というファイルを作成 or ファイル名を変更した場合、ターミナルで `ls -l | grep ガーベージ` としても `ガーベージ.md` はヒットしません**。このようなファイル名をコピーし、本文に貼り付けた場合はファイル名以外の部分にも[[UTF-8-MAC]]が波及してもはやカオスになります。詳細は以下をご覧ください。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" /> <span class="link-card-v2-site-name">Minerva</span> </div> <div class="link-card-v2-title"> 📝macOSでfdのクエリが濁点を含むとファイルの検索結果にヒットしない </div> <div class="link-card-v2-content">macOSでfdやgrepコマンドで「ガーベージ」など濁点を含むファイル名が検索できない事象である。原因はファイル名がNFD（UTF-8-MAC）で正規化されているためで、クエリはNFCで入力されることが多く一致しない。convmvでNFC正規化することで解決できる。</div> <img class="link-card-v2-image" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/Notes/attachments/troubleshooting.webp" /> <a data-href="📝macOSでfdのクエリが濁点を含むとファイルの検索結果にヒットしない" class="internal-link"></a> </div> %%[[📝macOSでfdのクエリが濁点を含むとファイルの検索結果にヒットしない]]%% #### `.DS_Store` ファイルができてしまう `.DS_Store` はフォルダの表示情報などを格納するファイルで、[[Finder]]が生成・参照します。逆に、[[Finder]]を使っていない人からすれば不要なファイル...、むしろアップロードすると害のあるファイルとして敬遠されています。私のローカルディレクトリも気がついたら `.DS_Store` ファイルまみれになっていました。 #### デフォルトのキーバインドが直感的でないこれは好みの問題でもあると思いますが、他の場面でファイル操作をするときとキーが違いすぎて考えずに操作できません。`Enter` ではファイル名変更ではなくファイルを開きたいです。また、[[karabiner.ts]]で[[Finder]]使用中のキーマップを変更したこともありますが、[[Raycast]]起動時の操作に影響を及ぼすので断念しました。 ### ファイルマネージャーに求めるもの私がファイルマネージャーに求めることは、まずFinderの不満点が解消されていることです。 - 文字コードは[[UTF-8]]に統一されている - キーバインドが直感的であるまたはカスタマイズできる - 余計なファイルが生成されないもちろん、[[Finder]]で実装されているような基本機能は必要です。 - 基本機能(作成・移動・コピー・貼り付け・削除・リネーム)が使える - 画像ファイルをプレビューできる - お気に入りを登録・利用・検索できる加えて、以下の機能もあると望ましいです。 - タブのようなUIで複数Viewを開ける - [[ファジー検索]]できる - キーボードで快適に操作できる - 設定が[[Git]]で管理できる - [[oil.nvim]]に近い操作性 ### [[oil.nvim]]について [[oil.nvim]]は、[[Neovim]]のファイルマネージャープラグインです。私はほぼすべての開発作業を[[Neovim]]で行っており、作業中のファイル操作はすべて[[oil.nvim]]を使っています。そのため、[[Finder]]の代わりとして[[oil.nvim]]を使うことも多いのですが、**画像のプレビューが不安定**だったり、**OSクリップボードとの連携に限界**があり[^1]、[[Finder]]を使い続けていました。 [[oil.nvim]]を推している理由は以下の記事をご覧ください。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" /> <span class="link-card-v2-site-name">Minerva</span> </div> <div class="link-card-v2-title"> 📘あまり紹介されていないけどかけがえのないNeovimプラグインたち </div> <div class="link-card-v2-content">日本語サイトでほとんど紹介されていないNeovimプラグインを厳選し、flash.nvimやoil.nvimなど5つを詳しく解説しています。ファイルエクスプローラーやLSP連携、ウィンドウ配置、効率的なファイル検索など、Neovimを快適に使うためのおすすめプラグインを知りたい方はぜひご覧ください。</div> <img class="link-card-v2-image" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/%F0%9F%93%98Articles/attachments/2024-03-27.webp" /> <a data-href="📘あまり紹介されていないけどかけがえのないNeovimプラグインたち" class="internal-link"></a> </div> %%[[📘あまり紹介されていないけどかけがえのないNeovimプラグインたち]]%% せっかくなので、手に染み付いている[[oil.nvim]]と似たような操作感のファイルマネージャーがあれば、それに越したことはないと思っていました。 ## [[Yazi]]の発見そんなとき、[[Yazi]]というファイルマネージャーがあることを知りました。しかも[[ターミナル]]で完結する[[TUI]]ツールです。見た目もシンプルでクールだと思います。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> GitHub - sxyazi/yazi: 💥 Blazing fast terminal file manager written in Rust, based on async I/O. </div> <div class="link-card-v2-content"> 💥 Blazing fast terminal file manager written in Rust, based on async I/O. - sxyazi/yazi </div> <img class="link-card-v2-image" src="https://repository-images.githubusercontent.com/663900193/c1f495b1-8d69-4dba-a7e3-dbfde3a817f6" /> <a href="https://github.com/sxyazi/yazi"></a> </div> [[Rust]]で書かれており、非同期処理も作り込まれていて優れたパフォーマンスを発揮します。パフォーマンスへのこだわりは [作者のブログ記事](https://yazi-rs.github.io/blog) からも伝わってきます。また、カスタマイズ性も非常に高いです。キーマップや設定の他に、以下のような仕組みがあります。 - [[Yaziプラグイン]] - [[フレーバー (Yazi)|フレーバー]] (テーマ) - [[DDS (Yazi)|DDS]] ([[PubSub|Pub/Sub]]による制御) もちろん、機能も充実しており、**先ほど挙がった以下の要件をすべて**満たします。 - 文字コードは[[UTF-8]]に統一されている - **キーバインドが直感的であるまたはカスタマイズできる** - 余計なファイルが生成されない - **基本機能(作成・移動・コピー・貼り付け・削除・リネーム)が使える** - **画像ファイルをプレビューできる** - **お気に入りを登録・利用・検索できる** - タブのようなUIで複数Viewを開ける - **[[ファジー検索]]できる** - キーボードで快適に操作できる - **設定が[[Git]]で管理できる** - **[[oil.nvim]]に近い操作性** ## 準備本題に入る前の準備です。 ### Yaziのインストールインストールは[[Homebrew]]で行いました。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> Installation | Yazi </div> <div class="link-card-v2-content"> How to install Yazi on various operating systems. </div> <a href="https://yazi-rs.github.io/docs/installation"></a> </div> ```console brew install yazi ``` [[Yazi]]は本体とは別に、必須ではない機能を追加する場合にインストールすべき依存関係があります。 `-` はインストール済、`x` は不要、`?` は不明、`O` は今回インストールしたものを指します。 | 依存関係 | 用途 | インストール | | --------------------------------------- | ---------------- | ------ | | [[Nerd Fonts]] | アイコン表示 | O | | [[ffmpeg]] | 動画のサムネイル | - | | [[7-zip]] | アーカイブ抽出・プレビュー | ？ | | [[jq]] | [[JSON]]プレビュー | - | | [[Poppler]] | [[PDF]]プレビュー | O | | [[fd]] | ファイル検索 | - | | [[ripgrep]] | ファイル内検索 | - | | [[fzf]] | [[ファジー検索]] | - | | [[zoxide]] | 履歴から移動 | - | | [[resvg]] | [[SVG]]プレビュー | O | | [[ImageMagick]] | フォントなどのプレビュー | - | | [[xclip]] / [[wl-clipboard]] / [[xsel]] | [[Linux]]クリップボード | x | ```console brew install poppler resvg font-symbols-only-nerd-font ``` ### 環境執筆時の環境です。 | 対象 | バージョン | | --------------- | ------------------- | | [[macOS]] | 15.6.1 | | [[Ghostty]] | 1.1.4-main+3e79c4b7 | | [[Yazi]] | 25.5.31 | | [[ffmpeg]] | 8.0 | | [[jq]] | 1.8.1 | | [[fd]] | 10.2.0 | | [[ripgrep]] | 14.1.1 | | [[fzf]] | 0.63.0 | | [[zoxide]] | 0.9.8 | | [[ImageMagick]] | 7.1.2-3 | | [[resvg]] | 0.45.1 | ### 設定ファイルと場所設定は `~/.config/yazi/` 配下に作成します。重要なファイルは以下3つです。 | ファイル名 | 用途 | | ------------- | ---------------- | | `yazi.toml` | [[Yazi]]本体の設定に使用 | | `keymap.toml` | キーマップの設定に使用 | | `init.lua` | プラグインの初期化などに使用 | ### 最初に設定・確認すること公式ドキュメントのクイックスタートを確認しましょう。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> Quick Start | Yazi </div> <div class="link-card-v2-content"> A quick guide on the basic usage of Yazi. </div> <a href="https://yazi-rs.github.io/docs/quick-start"></a> </div> #### シェルラッパーの定義 `.bashrc` や `.zshrc` で、以下の関数を定義することが推奨されています。この関数を定義すると、**[[Yazi]]を終了したあとに、ターミナルのカレントディレクトリが[[Yazi]]で最後に開いていたディレクトリに変更**されます。 ```bash function y() { local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd yazi "$@" --cwd-file="$tmp" IFS= read -r -d '' cwd < "$tmp" [ -n "$cwd" ] && [ "$cwd" != "$PWD" ] && builtin cd -- "$cwd" rm -f -- "$tmp" } ``` > [!hint] > [[Yazi]]起動前のディレクトリに戻したい場合は、逆に `y()` 関数を定義しないようにしましょう。 #### 主要キーバインドの確認 [Keybindings](https://yazi-rs.github.io/docs/quick-start#keybindings) に掲載されているデフォルトキーバインドを一通り確認しておきましょう。もし、あなたが[[Neovim]]ユーザーであれば、馴染のあるコマンドが多いのではないでしょうか。 [選択のキーバインド](https://yazi-rs.github.io/docs/quick-start/#selection)や[ファイル操作のキーバインド](https://yazi-rs.github.io/docs/quick-start#file-operations)は少し癖があるので、慣れるまで時間がかかるかもしれません。基本的には **『Shift修飾キーが入ると状態解除』** と理解しておくと覚えやすいです。(この意味は今分からなくても問題ありません) ## オススメ機能 ### 画像プレビュー [[Yazi]]の画像プレビューは[[TUI]]と思えないほど安定しています。 [[Neovim]]で[[oil.nvim]]や[[snacks.nvim]]を使っているときは、2度目の画像描画がされなくなる問題に常時直面していましたが、[[Yazi]]の画像プレビューが表示されなかったことは1度もありません。 [[macOS]] + [[Ghostty]]の組合わせしか試してはいませんが、[Image Preview | Yazi](https://yazi-rs.github.io/docs/image-preview) に記載されている通り、ほぼすべてのプラットフォームとプロトコルに対応しています。 ![[2025-09-14-15-43-49.avif|frame]] *YaziでWebP画像をプレビュー表示* 特に最近は画像を編集する機会が増えたので、プレビュー表示で確認をしつつ、ファイル移動や操作、別ファイル形式への変換なども[[Yazi]]で完結できるようにしました。やり方は後ほど紹介します。 ### [[oil.nvim]]ライクなファイル操作 [[oil.nvim]]に限らず、[[Neovim]]のファイルマネージャープラグイン全般と似たような操作だと思います。普段、[[TUI]]や[[Neovim]]の操作に慣れている方はとっつきやすいと思います。 1つ1つ説明すると長くなってしまうので、動画を作成しました。字幕の説明はありませんが、入力キーを右上に表示しています。何をやっているかはなんとなく感じとっていただければと。 ![](https://youtu.be/sfIYRxqzcbc?si=EdkQso2dl2JwWEn7) `v` でビジュアルモードに遷移して操作したり、複数リネームでエディタが開いたりするあたりは非常にエモい感じがしました☺️ ## 利用しているプラグイン [[Yaziプラグイン]]を使って機能を自分好みに拡張できるのも[[Yazi]]の大きな魅力です。私が利用しているプラグインを紹介します。 > [!attention] > - インストール方法や設定方法は、プラグインリポジトリのREADMEをご覧ください > - 設定やキーマップは [[#設定]] と [[#キーマップ]] にまとめたものがあるため割愛します > - 一部のプラグインは説明が長くなるため別セクションに誘導しています ### [[smart-enter.yazi]] 『ファイルを開く』操作と『ディレクトリ内に移動する』操作を1つのコマンド(キー)で実行できるようにするプラグインです。[[OS]]のファイルマネージャーも同じような挙動になっていることが多いので、多くの方にオススメできます。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> plugins/smart-enter.yazi at main · yazi-rs/plugins </div> <div class="link-card-v2-content"> Place code snippets from docs into this monorepo, so that users can update more easily via package manager. - ya ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/563a9bce2a9335f3ed7594ea031529b3c13749b06b17619b1c064dcee123d2b0/yazi-rs/plugins" /> <a href="https://github.com/yazi-rs/plugins/tree/main/smart-enter.yazi"></a> </div> ### [[full-border.yazi]] 外側にボーダーを表示するだけのプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> plugins/full-border.yazi at main · yazi-rs/plugins </div> <div class="link-card-v2-content"> Place code snippets from docs into this monorepo, so that users can update more easily via package manager. - ya ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/563a9bce2a9335f3ed7594ea031529b3c13749b06b17619b1c064dcee123d2b0/yazi-rs/plugins" /> <a href="https://github.com/yazi-rs/plugins/tree/main/full-border.yazi"></a> </div> それだけではあるのですが結構印象が変わります。 ![[2025-09-14-18-32-24.avif|frame]] *full-border.yazi **未**利用時* パスやステータスバーとの分かれ目がハッキリして全体が引き締まります。 ![[2025-09-14-18-33-19.avif|frame]] *full-border.yazi 利用時* ### [[bunny.yazi]] ブックマークを扱うプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> GitHub - stelcodes/bunny.yazi: 🐰 Bookmarks menu for yazi with persistent and ephemeral bookmarks, fuzzy searching, previous directory, directory from another tab </div> <div class="link-card-v2-content"> 🐰 Bookmarks menu for yazi with persistent and ephemeral bookmarks, fuzzy searching, previous directory, directo ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/65a5a5bbf10fa418e1b406fc2debcb9f4e8d0297e75755845bad148950b6fee4/stelcodes/bunny.yazi" /> <a href="https://github.com/stelcodes/bunny.yazi"></a> </div> こちらの詳細は、[[#ブックマークで移動]] で紹介します。 ### [[zoxide.lua (Yazi)|zoxide.lua]] [[zoxide]]を使って最近移動したディレクトリパスの一覧を表示し、選択したディレクトリへ移動できるプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> Builtins | Yazi </div> <div class="link-card-v2-content"> Learn how to configure Yazi's built-in plugins. </div> <a href="https://yazi-rs.github.io/docs/plugins/builtins/#zoxide"></a> </div> [[zoxide.lua (Yazi)|zoxide.lua]]はビルトイン拡張のため、プラグインのインストールは不要です。こちらの詳細は、[[#最近移動したディレクトリに移動]] で紹介します。 ### [[fzf.lua (Yazi)|fzf.lua]] [[fzf]]を使って[[ファジー検索]]やナビゲート機能を提供するプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> Builtins | Yazi </div> <div class="link-card-v2-content"> Learn how to configure Yazi's built-in plugins. </div> <a href="https://yazi-rs.github.io/docs/plugins/builtins/#fzf"></a> </div> [[fzf.lua (Yazi)|fzf.lua]]はビルトイン拡張のため、プラグインのインストールは不要です。こちらの詳細は、[[#カレントディレクトリ配下のファイルに移動]] で紹介します。 ### [[system-clipboard.yazi]] クリップボードにファイルをコピーしたり、クリップボードからファイルを貼り付けたりできるプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> GitHub - orhnk/system-clipboard.yazi: Cross platform implementation of a simple system clipboard for yazi file manager </div> <div class="link-card-v2-content"> Cross platform implementation of a simple system clipboard for yazi file manager - orhnk/system-clipboard.yazi </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/d958f3825969fd3c4e5c78317fbb467324a86fe89b047e5b7643b61052d9f28d/orhnk/system-clipboard.yazi" /> <a href="https://github.com/orhnk/system-clipboard.yazi?tab=readme-ov-file"></a> </div> こちらの詳細は、[[#他ツールとファイルをやりとりする]] で紹介します。 ### [[toggle-pane.yazi]] プレビュー領域を最大化/最小化できるようにするプラグインです。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> plugins/toggle-pane.yazi at main · yazi-rs/plugins </div> <div class="link-card-v2-content"> Place code snippets from docs into this monorepo, so that users can update more easily via package manager. - ya ... </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/563a9bce2a9335f3ed7594ea031529b3c13749b06b17619b1c064dcee123d2b0/yazi-rs/plugins" /> <a href="https://github.com/yazi-rs/plugins/tree/main/toggle-pane.yazi"></a> </div> 普段は小さいプレビュー画面を一時的に最大化/最小化できます。私が実際に使うのは最大化のみです。 ![[2025-09-14-20-28-40.avif|frame]] *通常の画像プレビュー表示* ![[2025-09-14-20-29-21.avif|frame]] *toggle-pane.yazi の max-preview 実行後* プレビューを最大表示した状態でも、カーソル移動やディレクトリ移動はできます。ただ、どこを操作しているのかが見えないのは非常に玄人向けですので、連続した画像やファイルのプレビューを最大表示したい場合以外はオススメしません。 ## 多様なディレクトリ移動方法 [[#oil.nvim に近い操作性]] でお見せした動画以外にも、様々な移動方法があります。 - パスを指定して移動 - ブックマークで移動 - 最近移動したディレクトリに移動 - カレントディレクトリ配下を再帰的に検索して移動これらをマスターすれば、[[Yazi]]から抜けてターミナルで操作する機会は激減することでしょう。 ### パスを指定して移動ターミナルで `cd` コマンドを打つのと同じように、[[Yazi]]にも `cd` コマンドがあります。 `keymap.toml` ```toml [mgr] prepend_keymap = [ { on = ["i", "<Space>"], run = "cd --interactive" }, ] ``` ファイルマネージャーを操作していると、一度ターミナルに戻って直接パスを打ち込み `cd` したくなる瞬間がやってきます。[[Yazi]]であれば、ターミナルに戻らずともその場で同等の体験が可能です。 ![](https://youtu.be/DrvQkWWt3gw) ### ブックマークで移動 [[bunny.yazi]]を使ってブックマークへ素早く移動できます。 `keymap.toml` ```toml [mgr] prepend_keymap = [ { on = "e", run = "plugin bunny" }, ] ``` `hops` にあらかじめ登録しておきたいブックマークを記載します。`key` は `e` のあとに入力されるキーであり、その後 `path` に移動します。 `init.lua` ```lua require("bunny"):setup({ hops = { { key = "/", path = "/" }, { key = "~", path = "~", desc = "Home directory" }, { key = "c", path = "~/.config", desc = "Config files" }, { key = "d", path = "~/Downloads", desc = "Downloads" }, { key = "e", path = "__FUZZY__", desc = "Fuzzy search" }, { key = "g", path = "~/git/github.com/tadashi-aikawa", desc = "GitHub" }, { key = "p", path = "~/Documents/Pictures", desc = "Pictures" }, }, }) ``` `path = "__FUZZY__"` の場合は、ブックマーク一覧の[[ファジー検索]]が起動します。 > [!attention] > `Fuzzy search` には[[fzf]]が必要です。実際の動きを見てみましょう。 ![](https://youtu.be/woX5rOSdVFw) ### 最近移動したディレクトリに移動 [[zoxide.lua (Yazi)|zoxide.lua]]を使って、最近移動したディレクトリの候補を一覧表示して移動できます。 `keymap.toml` ```toml [mgr] prepend_keymap = [ { on = ["z", "i"], run = "plugin zoxide", desc = "zoxide" }, ] ``` デフォルトでは[[Yazi]]操作中にカレントディレクトリを移動しても、[[zoxide]]の履歴データベースに登録されません。`setup` で `update_db = true` を指定することにより、[[Yazi]]操作中の履歴も登録します。 `init.lua` ```lua require("zoxide"):setup({ update_db = true, }) ``` > [!attention] > [[zoxide]]と[[fzf]]が必要です。私はターミナルでディレクトリ移動する際に[[zoxide]]を使うことが非常に多いので、[[Yazi]]の中で直接呼び出せるのは非常にありがたいです。実際の動きを見てみましょう。 ![](https://youtu.be/ausMf9CptXE) ### カレントディレクトリ配下を再帰的に検索して移動 [[fzf.lua (Yazi)|fzf.lua]]を使って、カレントディレクトリ配下を再帰的に検索して、対象ディレクトリまたは対象ファイルのあるディレクトリに移動できます。 `keymap.toml` ```toml [mgr] prepend_keymap = [ { on = ["z", "f"], run = "plugin fzf" }, ] ``` > [!attention] > [[fzf]]が必要です。以下の動画は、カレントディレクトリ配下のファイルを検索して移動しています。しかし、それだけではなく、複数のエントリを[[fzf]]のインターフェースで選択して決定することで、[[Yazi]]に選択状態を引き継いでいます。 ![](https://youtu.be/LqHRJJMY7l8) ## 他ツールとファイルをやりとりする [[Yazi]]のヤンク(コピー)やペーストはクリップボードではなく[[Yazi]]内部でデータが管理されています。そのため、[[Yazi]]以外のツールでコピーしたものをペーストしたり、[[Yazi]]でヤンクしたものを他のツールでペーストすることができません。これまでの操作はすべて[[Yazi]]で完結していたため、そのような問題は起こりませんでしたが、ツールをまたいだコピー・ペーストは実際によく遭遇するユースケースです。これに対応するため[[system-clipboard.yazi]]を使います。 `keymap.toml` ```toml [mgr] prepend_keymap = [ { on = "<C-c>", run = "plugin system-clipboard" }, { on = "<C-v>", run = "shell 'cb paste' --block" }, ] ``` > [!info] > [[Clipboard Project]]の `cb` コマンドを使っています。この設定により、`<C-c>` でクリップボードへのコピーが、`<C-v>` でクリップボードからのペーストができます。 ![](https://youtu.be/_Cl9Rciiyx4) > [!question]- ドラッグ&ドロップはできるのか？ > [[Yazi]]の[[TUI]]はドラッグ&ドロップ機能を提供していませんが、[Dragonを使った方法が公式ドキュメントのTipsで紹介されています](https://yazi-rs.github.io/docs/tips#drag-and-drop)。 > しかし、私の環境ではDragonによるドラッグ&ドロップUIは表示されましたが、そこでドラッグ&ドロップしても何も起こらなかったのであきらめました。 > > 代わりに[[Raycast]]の[[Clipboard History (Raycast Extension)|Clipboard History]]を使って、クリップボードにコピーされたコンテンツを別ツールにドロップしています。 ## キーマップ `keymap.toml` を編集することでキーマップをほぼ完全にカスタマイズできます。設定できる項目は以下の公式ドキュメントをご覧ください。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> keymap.toml | Yazi </div> <div class="link-card-v2-content"> Learn how to configure keyboard shortcuts with Yazi. </div> <a href="https://yazi-rs.github.io/docs/configuration/keymap/"></a> </div> ここでは私の `keymap.toml` を紹介します。 ```toml [mgr] prepend_keymap = [ { on = "-", run = "leave", desc = "親ディレクトリへ移動" }, { on = "<C-c>", run = "plugin system-clipboard" }, { on = "<C-i>", run = "forward" }, { on = "<C-o>", run = "back" }, { on = "<C-p>", run = "plugin toggle-pane max-preview" }, { on = "<C-v>", run = "shell 'cb paste' --block", desc = "Paste from clipboard" }, { on = "<Enter>", run = "plugin smart-enter" }, { on = "e", run = "plugin bunny" }, { on = "f", run = "search" }, { on = "o", run = "create" }, { on = "q", run = "close" }, { on = ["z", "f"], run = "plugin fzf", desc = "fzf under current directory" }, { on = ["z", "i"], run = "plugin zoxide", desc = "zoxide" }, { on = ["<Space>", "g"], run = "shell --block -- lazygit" }, { on = ["<Space>", "w"], run = 'shell --block --interactive -- magick "$0" "$0.webp"', desc = "Convert an image to WebP" }, { on = ["<Space>", "v"], run = 'shell --block --interactive -- magick -quality 35 "$0" "$0.avif"', desc = "Convert an image to WebP" }, { on = ["g", "?"], run = "help" }, { on = ["g", "r"], run = 'shell -- ya emit cd "$(git rev-parse --show-toplevel)"' }, { on = ["i", "<Space>"], run = "cd --interactive", desc = "パスを入力してcd" }, ] [input] prepend_keymap = [ { on = "<Esc>", run = "close", desc = "Cancel input" } ] ``` 各キーバインドに割り当てられた操作の概要一覧です。 | キーバインド | 操作の概要 | 備考 | | ---------- | -------------- | ---------------------------------------- | | `-` | 親ディレクトリへ移動 | [[oil.nvim]]にあわせて | | `<C-c>` | クリップボードにコピー | [[system-clipboard.yazi]]が必要 | | `<C-v>` | クリップボードから貼り付け | [[Clipboard Project]]が必要 | | `<C-i>` | 1つ先のディレクトリに移動 | [[Vim]]の `<C-i>` 相当 | | `<C-o>` | 1つ前のディレクトリに移動 | [[Vim]]の `<C-o>` 相当 | | `<C-p>` | プレビュー最大化 | [[toggle-pane.yazi]]が必要 | | `<Enter>` | ディレクトリなら中に入る | [[oil.nvim]]にあわせて | | `e` | ブックマークメニュー | [[bunny.yazi]]が必要 | | `f` | [[エントリ]]検索 | [[Vim]]の[[クイックフィックス (Vim)\|クイックフィックス]]相当 | | `o` | [[エントリ]]作成 | [[oil.nvim]]にあわせて | | `q` | タブを閉じる | タブが1つの場合は[[Yazi]]を終了 | | `zf` | [[ファジー検索]] | [[fzf]]が必要。cwd配下(再帰的)が対象 | | `zi` | 最近のディレクトリ移動 | [[zoxide]]が必要 | | `<Space>g` | [[Lazygit]]を開く | [[Lazygit]]が必要 | | `<Space>w` | [[WebP]]画像作成 | [[ImageMagick]]が必要 | | `<Space>v` | [[AVIF]]画像作成 | [[ImageMagick]]が必要 | | `g?` | ヘルプ表示 | [[oil.nvim]]にあわせて | | `gr` | gitのrootに移動 | | | `i<Space>` | パスを指定して移動 | ターミナルの `cd` 相当 | `input.prepend_keymap` は [[#`<ESC>`を2回押さないとファイル名入力欄が消えない]] の対策です。 ## 設定 `yazi.toml` で設定を変更できます。設定できる項目は以下の公式ドキュメントをご覧ください。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://yazi-rs.github.io/webp/logo.webp" /> <span class="link-card-v2-site-name">yazi-rs.github.io</span> </div> <div class="link-card-v2-title"> yazi.toml | Yazi </div> <div class="link-card-v2-content"> Learn how to configure Yazi's basic functionality. </div> <a href="https://yazi-rs.github.io/docs/configuration/yazi"></a> </div> 私の `yazi.toml` を紹介します。設定はできるだけ最小限にしています。 ```toml [mgr] show_hidden = true # 隠しファイルを表示する linemode = "mtime" # エントリ名以外に『最終更新日時』だけ表示 [preview] # toggle-pane.yaziプラグインの設定 max_width = 3600 # retinaも考慮して画面フルの解像度はサポート max_height = 2338 # retinaも考慮して画面フルの解像度はサポート [opener] # ファイルを開く挙動の設定 gimp = [ { run = 'LANG=ja gimp -n "$0"', desc = "GIMP"} # GIMPで開く ] [open] # ファイルごとにどのopenerを使うか prepend_rules = [ { mime = "image/*", use = "gimp" }, # 画像ファイルならgimpのみ ] [[plugin.prepend_fetchers]] # git.yaziプラグインの設定 id = "git" name = "*" run = "git" [[plugin.prepend_fetchers]] # git.yaziプラグインの設定 id = "git" name = "*/" run = "git" ``` ## 他ボリュームの関係で今回紹介しきれなかった内容も一部あります。興味がありましたら以下をご覧ください。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" /> <span class="link-card-v2-site-name">Minerva</span> </div> <div class="link-card-v2-title"> 📒Yaziのユースケース </div> <div class="link-card-v2-content">Yaziでよく使う設定や操作方法について。</div> <img class="link-card-v2-image" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/Notes/attachments/hub.webp" /> <a data-href="📒Yaziのユースケース" class="internal-link"></a> </div> %%[[📒Yaziのユースケース]]%% ### トラブルシューティング #### [[Neovim]]でファイルを開けない `<Enter>` を押しても[[Neovim]]で開けない場合、環境変数 `EDITOR` を設定します。 ```bash export EDITOR=nvim ``` > [Why can't I edit text files?](https://yazi-rs.github.io/docs/faq#why-cant-edit) #### `<ESC>`を2回押さないとファイル名入力欄が消えないデフォルトでは[[Vim]]っぽい挙動になっているため、1度目の`<ESC>`が[[ノーマルモード]]への移行と判定されてしまうからです。入力コンポーネント表示時の `<ESC>` に対するキーマップを上書きします。 ```toml [input] prepend_keymap = [ { on = "<Esc>", run = "close", desc = "Cancel input" } ] ``` > [Close input by once Esc press](https://yazi-rs.github.io/docs/tips#close-input-by-esc) ## まとめ [[TUI]]ファイルマネージャーの『[[Yazi]]』について、導入の経緯からオススメの機能、プラグイン、ユースケース、私のキーマップと設定を紹介しました。正直なところ、今はまだ『考えるより先に指が動く』境地には至っていません。しかし、 [[Yazi]]の環境を整備したかいもあって、[[Finder]]を使うことはほとんどなくなりました。毎日、[[Ghostty]]の中で快適なファイルマネージャーライフを送っています。もし貴方が... [[Finder]]に不満を持ち、ターミナルに閉じこもっていたい[[Vimmer]]の方であるなら... 今すぐ[[Yazi]]をインストールしてカスタマイズを始めてみるのも一興かもしれません。 [^1]: もしかしたら設定次第では上手くできるのかもしれませんが、[[Neovim]]利用前提である[[oil.nvim]]の設定をそこまで突き詰めるかは疑問だったので試していません。