superfile とは
superfile は開いたままのパネルを中心に組み立てられたターミナルのファイルマネージャーです。複数のディレクトリが横に並び、サイドバーにはホームのショートカット、ピン留めしたフォルダー、マウント済みのディスクが並び、プレビューペインがカーソルの下にあるものをそのまま描きます。シンタックスハイライト付きのソース、プレーンテキスト、ディレクトリの中身、画像。コピー、移動、圧縮はバックグラウンドで走ってプロセスバーに進捗を出すので、大きな転送で見ているパネルが固まることはありません。削除したファイルはゴミ箱に入って戻せますし、アーカイブはその場で展開も作成もでき、キー、色、罫線文字、パネル幅はすべて TOML ファイルの 1 行です。単一の静的 Go バイナリで、打つコマンドは spf です。
> プロンプト、そして伸び続けるプラグイン一覧。どれも config.toml と hotkeys.toml に新しいキーを連れてくるので、古いバイナリは現在のドキュメントが設定を勧めている項目を黙って無視します。Debian も Ubuntu も superfile をパッケージ化していないので、最新ビルドはここでは贅沢ではなく、apt で手に入れる唯一の方法です。
⚡ superfile の主な機能
🪟 ディレクトリ 1 つではなく、パネル
n でファイルパネルをもう 1 枚開き、tab で行き来します。パネルごとにパス、並び順、選択状態を持つので、2 つのツリー間のコピーは長いパス 2 本ではなくキー 2 つで済みます。
👀 カーソルに追従するプレビュー
横のペインが、動かすたびに選択中のファイルを描きます。内蔵 chroma か bat でハイライトしたソース、ディレクトリの中身、そして描画できるターミナルなら画像も。幅が欲しいときは f でたためます。
♻️ 取り消せる削除
ctrl+d はファイルを消さずにゴミ箱へ送るので、押し間違えても取り返せます。D は別に用意された、意図して使う完全削除です。
📊 長い処理にはプロセスバー
コピー、移動、圧縮は進捗を持つバックグラウンドジョブとして走り、p のプロセスパネルに並びます。数 GB が動いている間もファイルパネルはそのまま使えます。
🗜️ 探す、飛ぶ、固める、展開する
/ は打ちながら現在のディレクトリを絞り込み、zoxide が入っていれば z が移動を任せ、ctrl+a は選択を圧縮し、ctrl+e はアーカイブをその場で展開します。
🎨 設定は自分の手で
config.toml と hotkeys.toml がひとつずつ。すべてのキーは付け替えられ、既定の隣には Vim 用のセットも同梱。テーマは自分で書けるファイルで、サイドバー幅、罫線文字、既定の並び順、プレビュー幅もすべて設定項目です。
apt upgrade を実行するだけで、常に最新版を使い続けられます。
📦 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 update🆓 ずっと無料のミラーがあります。 deb-free.griffo.io は、アカウントもサブスクリプションもなしでパッケージをずっと無料で配布しています。上流より最大2か月遅れ、セキュリティ修正は即座に公開されます。現在収録しているのは cliamp、Ghostty、lazydocker、Oh My Posh と Zed です。superfile は含まれていないため、今日入手する方法は上のリポジトリだけですが、ご要望があれば追加できます。
ステップ 2: superfile をインストールする
# 最新の superfile をインストール
sudo apt install superfile
# 任意: 必要とするプラグイン向けに、メタデータパネル用の exiftool と
# 賢いディレクトリ移動用の zoxide
sudo apt install libimage-exiftool-perl zoxide
# インストールを確認。コマンドは superfile ではなく spf です
spf --version# 最新の superfile をインストール
apt install superfile
# 任意: 必要とするプラグイン向けに、メタデータパネル用の exiftool と
# 賢いディレクトリ移動用の zoxide
apt install libimage-exiftool-perl zoxide
# インストールを確認。コマンドは superfile ではなく spf です
spf --versionステップ 3: 最初の起動
# いまいるディレクトリを開く
spf
# あるいは別の場所から始める
spf ~/Downloads
# コマンドラインにパスを 2 つ渡せばパネルも 2 枚
spf ~/src ~/Downloads
# 設定、ホットキー、テーマ、ログ、データの置き場所
spf path-list
# superfile の中では ? がホットキー一覧を開きます
spf --help🎯 基本的な使用例
起動する:
# 現在のディレクトリ
spf
# 指定したディレクトリ
spf /var/log
# パスごとに 1 枚、並べて開く
spf ~/src ~/Downloads /mnt/backup
# 自分のファイルに触れずに設定を試す
spf --config-file /tmp/spf.toml --hotkey-file /tmp/spf-keys.toml
# 入っているのはどのバージョン?
spf --version設定を最新に保つ:
# 新しいリリースで増えた項目とホットキーを追加する。
# すでに変更した内容はそのまま
spf --fix-config-file
spf --fix-hotkeys
# superfile が使うパスをすべて表示
spf path-list
# バグ報告用の環境、ターミナル、バージョン情報
spf --debug-infoシェルに組み込む:
# config.toml で cd_on_quit = true にし、これを ~/.bashrc か
# ~/.zshrc に置くと、Q で終了したときパネルが最後に表示していた
# ディレクトリに残れます
spf() {
export SPF_LAST_DIR="${XDG_STATE_HOME:-$HOME/.local/state}/superfile/lastdir"
command spf "$@"
[ ! -f "$SPF_LAST_DIR" ] || { . "$SPF_LAST_DIR"; rm -f -- "$SPF_LAST_DIR"; }
}
# その関数が読むパス
spf path-list --lastdir-file
# 他のプログラムのファイル選択画面として使う: 選んだパスを
# ファイルに書いて終了します
spf --chooser-file /tmp/picked🔧 ツール連携
superfile は専門的な仕事を、あなたがすでに使っている道具にあえて任せます:
- あなたのエディタ:
eは選択中のファイルを$EDITORで、Eはディレクトリをdir_editorで開きます。編集は Neovim や Helix のまま、superfile は見て回る側に徹します - zoxide:
zoxide_support = trueにすれば、zキーがシェルで何か月も育ててきた同じデータベースで移動します - exiftool:
libimage-exiftool-perlを入れてmetadata = trueにすると、メタデータパネルが基本情報ではなく EXIF とメディアの全項目を表示します - bat と chroma: プレビューのハイライトは内蔵 chroma が担当し、
batのテーマが好みならcode_previewer = "bat"で切り替えられます - ターミナルとシェル: 画像プレビューはターミナル自身の画像プロトコルを使い、
[open_with]に書いていない種類はxdg-openが引き受け、cd_on_quitが最後のディレクトリを bash、zsh、fish に返します
🚀 deb.griffo.io を選ぶ理由
- 公式 Ubuntu: superfile をパッケージ化していないので、素のシステムでは
apt install superfileが失敗します - ソースからビルド: 最新にはなりますが、マシンごとに Go のツールチェーンが要り、apt が知らないバイナリが残ります
- 上流のインストールスクリプト: superfile.dev から
curl一発で手軽ですが、パッケージマネージャーの外からシステムに書き込み、そのあとはバイナリ自身が更新を知らせてきます - deb.griffo.io: 最新版を自動更新でお届け
- ✅ apt で入る唯一の場所: superfile は Debian にも Ubuntu にも収録されていません。このリポジトリが上流公式のリリースをパッケージ化しています
- ✅ コマンドは spf: パッケージ名が superfile なのは上流がそう名乗っているからで、PATH に入るのは
/usr/bin/spf。チュートリアルもホットキー一覧も、みなこのコマンドを使います - ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新するので、
auto_check_updateは false にして確認は apt に任せられます - ✅ 完全なパッケージ: 上流公式の Linux ビルドを
/usr/bin/spfとして導入。足しても当ててもいません - ✅ 正直な依存関係: バイナリ自体は何も要求せず、
xdg-utilsは推奨止まり。exiftool、zoxide、ffmpeg、poppler-utils、クリップボードツールは、それを使う任意機能のための提案です - ✅ 2 つのアーキテクチャ: amd64 と arm64。どちらも静的リンクの Go バイナリなので、同じパッケージがどのスイートでも動きます
- ✅ マルチディストリビューション: Ubuntu 22.04、24.04、25.10、26.04 で動作
- ✅ 手間のかからない運用: 更新は通常の apt コマンドだけ
📦 パッケージのビルドリポジトリ
Ubuntu パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:
- 🗂️ superfile-debian - 最新リリースのビルド
🔗 関連パッケージ
deb.griffo.io では、こちらも配布しています:
- Yazi - ここにあるもう一つのターミナルファイルマネージャー。1 枚パネルと Lua プラグインが好みなら
- zoxide - superfile の
zキーの裏で動く移動データベース - eza - 現代的な ls。ファイルマネージャーを開くほどでもない一覧に
- fzf ファジーファインダー - シェルのプロンプトから始める探し物に
mv しかなかったターミナルに、プレビューとゴミ箱と進捗バーが欲しくなったときに。