コマンドライン on KnightLiブログ

Ghostty ドキュメント速読：インストール、設定、日常利用の要点

Fri, 15 May 2026 14:50:11 +0800

Ghostty は新しいターミナルエミュレーターだが、単に「また一つ速いターミナル」が増えたという話ではない。公式ドキュメントによると、Ghostty は速度、機能、ネイティブなデスクトップ体験の三つを同時に満たそうとしている。つまり、GPU アクセラレーションと良好なレンダリング性能を目指しつつ、macOS と Linux ではできるだけ本物のローカルアプリのように振る舞い、すべての操作を独自描画 UI に押し込まない設計を目指している。

iTerm2、Kitty、Alacritty、WezTerm、あるいは OS 標準のターミナルを使っているなら、Ghostty で最も注目すべき点は単一の機能ではない。「すぐ使えること」と「深く設定できること」を同時に備えている点だ。デフォルト設定でもすぐ使える一方、さらに調整したくなったときには、設定ファイル、テーマ、キーバインド、フォント、Shell 統合、ターミナル制御シーケンスまで、公式ドキュメントが一通りの入口を用意している。

まず位置づけを見る

Ghostty の中核的な位置づけは、次の三点にまとめられる。

クロスプラットフォームなターミナルエミュレーターで、現時点では macOS と Linux に重点を置いている。
プラットフォームネイティブ UI を使う。macOS 版は Swift、AppKit、SwiftUI、Linux 版は Zig と GTK4 を使う。
ターミナルの中核は libghostty で、GUI アプリはこの共有コアを中心に構築されている。

この設計は日常体験に影響する。タブ、分割、エラーメッセージ、ウィンドウ状態の復元、システムショートカットなどは、単に「デスクトップアプリらしく見える部品」として作られているのではなく、各 OS の操作習慣にできるだけ近づけられている。macOS と Linux のデフォルトショートカットも、それぞれのプラットフォーム慣習に合わせて分けられている。

インストール：macOS は直接的、Linux はディストリビューション次第

公式のプリビルドバイナリは主に macOS 向けだ。もっとも一般的な方法は .dmg をダウンロードし、開いたあと Ghostty を Applications ディレクトリにドラッグすること。Homebrew ユーザーは、コミュニティが管理する cask も利用できる。

`1`	`brew install --cask ghostty`

Linux はより分散している。Ghostty のドキュメントでは、ディストリビューションごとのパッケージマネージャー、コミュニティバイナリ、ソースビルドが分けて説明されている。Arch、Alpine、Gentoo、NixOS、Snap、Solus、Void などにはそれぞれの経路がある。公式または信頼できるリポジトリがない場合、ドキュメントは第三者バイナリを気軽に入れるより、ソースからビルドする方向を勧めている。

これはサーバーや作業用マシンでは特に重要だ。ターミナルエミュレーターは大量の入出力、クリップボード、リンク、SSH セッション、ローカルファイルパスを扱う。インストール元は保守的に選び、公式 macOS パッケージ、ディストリビューションのリポジトリ、自分で出所を確認できるビルド手順を優先したい。

設定：いきなり大きな dotfiles をコピーしない

Ghostty の設定哲学は「ゼロ設定で使えること」だ。デフォルトフォントには JetBrains Mono が含まれ、Nerd Font もサポートされるため、多くのユーザーは最初に起動した時点で普通に作業できる。ドキュメントでは、主観的ではない設定を変えないと快適でない場合、それはデフォルト動作にすべきではないかと考えることさえ勧めている。

本当にカスタマイズが必要な場合、Ghostty はテキスト設定ファイルを使う。現在の設定ファイル名は config.ghostty で、旧バージョンでは config もサポートされる。代表的なパスは次の通り。

$XDG_CONFIG_HOME/ghostty/config.ghostty
$XDG_CONFIG_HOME/ghostty/config
$HOME/.config/ghostty/config.ghostty
$HOME/.config/ghostty/config

macOS では次の場所も読み込まれる。

1
2

$HOME/Library/Application Support/com.mitchellh.ghostty/config.ghostty
$HOME/Library/Application Support/com.mitchellh.ghostty/config

設定構文はとても直接的で、key = value という形だ。

font-family = JetBrains Mono
font-size = 14
theme = light:Rose Pine Dawn,dark:Rose Pine
keybind = ctrl+shift+t=new_tab

実用的な勧めとして、最初から他人の完全な設定をコピーしない方がよい。まず数日そのまま使い、最初はフォント、フォントサイズ、テーマの三つだけを変える。キーバインド、分割、ウィンドウ、Shell 統合で実際に摩擦を感じてから、必要な設定を一つずつ足していく方が安定する。

ドキュメント検索：ローカルでも完全な設定を確認できる

Ghostty には多くの設定項目があり、公式ドキュメントでは Option Reference にまとめられている。Web ページだけでなく、インストール後はローカルからも設定リファレンスを確認できる。

`1`	`ghostty +show-config --default --docs`

このコマンドはデフォルト設定とドキュメントを標準出力に出すため、ページャーにつなぐと検索しやすい。

`1`	`ghostty +show-config --default --docs \| less`

利用可能なフォントを見るには次を使う。

`1`	`ghostty +list-fonts`

内蔵テーマと利用可能なテーマを見るには次を使う。

`1`	`ghostty +list-themes`

デフォルトキーバインドを見るには次を使う。

`1`	`ghostty +list-keybinds --default`

これらのコマンドは、Web 上の断片をコピーするより信頼しやすい。自分が実際にインストールしている Ghostty のバージョンから出力されるからだ。

キーバインド：「アクション」を中心に考える

Ghostty のキーバインド設定形式は次の通り。

`1`	`keybind = trigger=action`

trigger はキー入力のトリガーで、action は Ghostty が実行する動作だ。新しいタブを作る、現在の surface を閉じる、設定を再読み込みする、プロンプトへジャンプする、といったものはすべて action になる。このモデルはわかりやすい。何かのメニュー項目を変更しているのではなく、入力シーケンスを一つの動作に紐づけている。

設定を変更した後は、実行中に再読み込みできる。デフォルトショートカットは次の通り。

Linux：ctrl+shift+,
macOS：cmd+shift+,

ただし、すべての設定が即時反映されるわけではない。新しく作るターミナルにだけ影響するものもあれば、完全な再起動が必要なものもある。「設定を書いたのに変わらない」と感じたら、構文を疑い続ける前に、その項目の説明を確認した方が早い。

テーマとフォント：まず内蔵を使い、その後で微調整する

Ghostty は多数のテーマを同梱しており、システムのライトモード、ダークモードに応じて別テーマへ切り替えることもできる。

`1`	`theme = light:Rose Pine Dawn,dark:Rose Pine`

テーマはカスタムファイルから読み込むこともできる。ドキュメントの注意は明確だ。テーマファイルは本質的には Ghostty の設定ファイルであり、多くの設定項目を指定できるため、信頼できない出所のテーマを安易に使うべきではない。

フォントについては、font-family を複数回指定して fallback フォントを設定できる。多言語環境では便利で、主フォントに英字や記号を担当させ、後続のフォントで中国語、日本語、その他の文字を補える。emoji、太字、斜体、リガチャなどの細部で問題が出たら、Option Reference で対応する項目を確認すればよい。

Shell 統合：SSH ユーザーは特に確認したい

Ghostty は bash、elvish、fish、nushell、zsh 向けに shell integration を自動注入できる。有効にすると、いくつかの体験が自然になる。

新しいターミナルを前のターミナルの作業ディレクトリから開ける。
複雑なプロンプトが resize 時に誤って回り込まず、再描画される。
プロンプトマーカーを使ってコマンド出力の間を移動できる。
プロンプト上で、編集習慣に合ったカーソル挙動が使える。

自動注入したくない場合は、設定で無効にできる。

`1`	`shell-integration = none`

さらに注意したいのは SSH だ。Ghostty は TERM として xterm-ghostty を使うが、多くのリモートホストにはまだ対応する terminfo がない。ドキュメントでは ssh-env と ssh-terminfo という二つの shell integration 機能が用意されており、デフォルトでは無効だが必要に応じて有効化できる。

`1`	`shell-integration-features = ssh-env,ssh-terminfo`

古いサーバー、コンテナ、踏み台、厳格に管理された本番環境へよく接続するなら、これらを有効にする前に公式の Terminfo と Shell Integration ドキュメントを読んでおきたい。ターミナル能力のネゴシエーションは地味だが、問題が起きると色の異常、ショートカットの不具合、全画面プログラムの表示崩れとして現れることがある。

私の試し方

Ghostty が自分に合うかだけを判断したいなら、次の順で試すとよい。

インストール後、設定を書かずに一日そのまま使う。
font-family、font-size、theme だけを調整する。
まず他人のショートカット表を取り込むのではなく、ghostty +list-keybinds --default でデフォルトを確認する。
SSH をよく使うなら、リモートホストの terminfo 互換性を先に確認する。
最後に分割、ウィンドウ、透明度、タイトルバー、背景画像などの見た目やワークフローの好みを調整する。

Ghostty のドキュメントはかなりエンジニアリング寄りで、「宣伝ページ」ではなく「設定リファレンスマニュアル」として読むのに向いている。多くのユーザーにとって、本当の判断基準は単純だ。デフォルト体験がすでに快適か、日常のエディタ、Shell、SSH、tmux、Zellij が安定しているか。このあたりがうまくいくなら、Ghostty は長期的なターミナル候補に入れる価値がある。

参考リンク

fdupesで削除順を制御する方法：ディレクトリ優先度で重複ファイルを残す

Wed, 06 May 2026 09:23:09 +0800

fdupes で重複ファイルを削除するとき、a、b、c の3つのディレクトリがあり、優先的に a を残し、次に b を残し、c の重複ファイルから削除したい場合、重要なのは複雑なルールではない。ディレクトリの入力順だ。

fdupes は非対話の削除モードでは、各重複グループで最初に見つかったファイルを残し、後から見つかった重複項目を削除する。そのため、ディレクトリ引数は「保持優先度が高いものから低いものへ」の順に並べる。

つまり、「先に c を削除し、次に b を削除し、できるだけ a を残す」には、次のように書く。

`1`	`fdupes -rdN a b c`

スキャン順は a -> b -> c になる。3つのディレクトリに同じファイルが存在する場合、a のファイルが先に見つかって保持され、b と c の重複ファイルが削除される。b と c だけに重複がある場合は、b が保持され、c が削除される。

パラメータの意味

よく使うパラメータは次の通り。

-r：サブディレクトリを再帰的にスキャンする。
-d：重複ファイルを削除する。
-N：-d と組み合わせて使い、対話確認を行わず、各重複グループの最初のファイルを残して残りを削除する。

そのため、重複ファイルを自動削除する基本形式は次のようになる。

`1`	`fdupes -rdN 目录A 目录B 目录C`

ディレクトリが前にあるほど保持優先度が高い。後ろにあるほど、重複ファイルが削除されやすくなる。

削除前にプレビューする

-dN を直接使うとファイルが削除されるため、まず重複ファイルのグループを確認するのがよい。

`1`	`fdupes -r a b c`

出力は重複ファイルごとにグループ化される。各グループで前に表示されるファイルが、非対話削除時に保持されやすいファイルだ。

統計情報を見ることもできる。

`1`	`fdupes -rm a b c`

データが重要な場合は、結果を保存して手動で確認する。

`1`	`fdupes -r a b c > duplicates.txt`

各重複グループの並び順が期待通りであることを確認してから、次を実行する。

`1`	`fdupes -rdN a b c`

サブディレクトリの扱い

-r を有効にすると、fdupes は渡されたディレクトリ配下のすべてのファイルを再帰的にスキャンする。保持優先度を決めるのは、やはりコマンド内でパスが登場する順序だ。

例えば次のように実行する。

`1`	`fdupes -rdN dir_a dir_b dir_c`

これは次の意味になる。

dir_a の優先度が最も高い。
dir_b がその次。
dir_c が最も低い。

dir_a/sub1/file.txt と dir_c/sub1/file.txt の内容が同じなら、dir_a 配下のファイルが保持される。dir_a/x/y/file.txt と dir_c/file.txt の内容が同じ場合も、dir_a 配下のファイルが優先される。fdupes が比較するのはファイル内容であり、ファイル名やディレクトリ階層が完全に一致する必要はない。

サブディレクトリの優先度を細かく制御する

親ディレクトリだけを渡す場合、サブディレクトリ内部のスキャン順は fdupes の走査ロジックに従う。多くの場合はこれで十分だ。ただし、特定のサブディレクトリにより高い優先度を与えたい場合は、そのサブディレクトリを明示的に前へ書く。

例えば、まず dir_a を残し、次に dir_b/special を残し、その後 dir_b の残りを処理し、最後に dir_c を処理したい場合は次のようにする。

`1`	`fdupes -rdN dir_a dir_b/special dir_b dir_c`

これにより、dir_b/special は dir_b より先にスキャンされる。その後 dir_b がスキャンされる時点では、special 内のファイルはすでに記録されているため、dir_b の他の部分より高い優先度を持つ。

この書き方は次のような需要に向いている。

a が最も重要な基準ディレクトリ。
b の中の特定サブディレクトリが、b の他の内容より重要。
c は主に低優先度のバックアップディレクトリ。

パス順はさらに拡張できる。

`1`	`fdupes -rdN a b/important b c/keep-first c`

ルールは変わらない。前にあるほど優先的に保持される。

ディレクトリが多い場合はリストを使う

ディレクトリやサブディレクトリが多い場合、長いコマンドを手で書くと間違えやすい。優先度順にパスを folders.txt のようなテキストファイルへ書いておくとよい。

/path/to/dir_a
/path/to/dir_b/sub_important
/path/to/dir_b
/path/to/dir_c/sub_1
/path/to/dir_c

その後、xargs で fdupes に渡す。

`1`	`cat folders.txt \| xargs fdupes -rdN`

パスに空白が含まれる可能性がある場合は、NULL文字区切りを使うほうが安全だ。

`1`	`tr '\n' '\0' < folders.txt \| xargs -0 fdupes -rdN`

注意すべき境界

第一に、fdupes が比較するのはファイル内容であり、ファイル名ではない。ファイル名が完全に違っていても、内容が同じなら重複ファイルとして扱われる。

第二に、a ディレクトリ内部に重複ファイルがある場合、fdupes -rdN a b c によって a 内部で後から見つかる重複項目も削除される可能性がある。このコマンドが表すのは「全体のスキャン順で最初に出たファイルを残す」ということであり、「a の中のファイルを絶対に削除しない」という意味ではない。

第三に、デフォルトでは fdupes はシンボリックリンクをたどらない。シンボリックリンク関連のファイルを処理する必要がある場合は、-s が必要かどうか、またそれがデータ安全上の期待に合うかを確認する。

第四に、fdupes は重複ファイルだけを削除し、空ディレクトリは削除しない。削除後に b や c に空フォルダが残った場合は、次を実行できる。

`1`	`find b c -type d -empty -delete`

より安全な操作習慣

ディレクトリ内のデータが重要な場合、いきなり -rdN を実行するのは避けたい。より安全な流れは次の通り。

まず fdupes -r a b c を実行して重複グループを見る。
各グループで先頭にあるファイルが本当に保持したいファイルか確認する。
その後 fdupes -rdN a b c を実行して自動削除する。
削除後、空ディレクトリの整理が必要か確認する。

a 内のファイルを誤って削除するのが非常に心配な場合は、低優先度ディレクトリだけを小さい範囲で先に整理するか、結果を出力して手動で絞り込むとよい。fdupes のディレクトリ順は便利だが、権限分離ルールではない。スキャン対象に含まれたパス内の重複ファイルは、削除判断に参加する可能性がある。

まとめ

fdupes で優先度に従って重複ファイルを削除する核心は、「残したいディレクトリ」を前に置き、「優先的に削除したいディレクトリ」を後ろに置くことだ。

a を残し、次に b を残し、c を優先的に削除するなら次のようにする。

`1`	`fdupes -rdN a b c`

特定のサブディレクトリの優先度を高くしたいなら、親ディレクトリより前に単独で書く。

`1`	`fdupes -rdN a b/important b c`

覚えることは一つでよい。fdupes -dN は先に現れた重複ファイルを残し、後に現れた重複ファイルを削除する。ディレクトリ順こそが保持優先度だ。

FFmpeg の `-map` パラメータの詳細な説明: ビデオ、オーディオ、および字幕ストリームの正確な選択

Thu, 02 Apr 2026 23:14:03 +0800

マルチオーディオトラックおよびマルチ字幕ビデオ処理では、-map は FFmpeg の最も重要で最も誤用されやすいパラメータの 1 つです。

-map を明示的に指定しない場合、FFmpeg はデフォルトのルールに従ってストリームを自動的に選択するため、多くの場合、期待した結果が得られません。例えば：

エクスポートすると字幕が失われる
間違ったオーディオトラック言語が選択されました
不要なデータストリームが混入している

この記事では、最も一般的なシナリオを使用して、-map の使用方法を説明します。

まずは「流れ」とは何かを理解する

通常、コンテナーファイルには複数のコンテンツストリーム (ストリーム) が存在します (mp4、mkv など)。一般的なものには次のようなものがあります。

ビデオストリーミング (v)
オーディオストリーム (a)
字幕ストリーム (s)
添付ファイル/データストリーム (フォント、表紙、章など)

まず ffprobe を使用して、ファイル内にどのようなストリームがあるかを確認できます。

`1`	`ffprobe -hide_banner input.mkv`

`-map` の基本構文

最も一般的な書き方は次のとおりです。

`1`	`-map input_index[:stream_type][:stream_index]`

例えば：

0:v: 1 番目の入力ファイルのすべてのビデオストリーム
0:a:0: 入力ファイル 1 のオーディオストリーム 1
1:s:1: 2 番目の入力ファイルの 2 番目の字幕ストリーム

例証します:

input_index は 0 から始まり、-i のシーケンスに対応します。
stream_index も 0 で始まります

実践例

1) ビデオは A から、音声は B から来ます

ffmpeg -i english.mp4 -i french.mp3 \
  -map 0:v:0 -map 1:a:0 \
  -c:v copy -c:a aac \
  french.mp4

意味：

english.mp4 の最初のビデオストリームを取得します
french.mp3 の最初のオーディオストリームを取得します
結合された出力は french.mp4 です。

2) 最初の入力のすべてのストリームを保持し、追加のオーディオトラックを追加します。

ffmpeg -i english.mp4 -i french.mp3 \
  -map 0 -map 1:a:0 \
  -c copy \
  english-french.mp4

意味：

-map 0 まず、すべてのストリームを最初の入力ファイルに取り込みます
2 番目の入力の最初のオーディオストリームを追加します

非常に実践的な 2 つの高度なテクニック

1) ネガティブマッピング: 不要なフローを除外します。

たとえば、最初の入力のすべてのストリームを保持しますが、2 番目のオーディオストリームを削除します。

`1`	`ffmpeg -i input.mkv -map 0 -map -0:a:1 -c copy output.mkv`

2) オプションのマッピング: ストリームは存在せず、中断されません。

一部のファイルには字幕がない場合があります。その場合は、? を使用できます。

`1`	`ffmpeg -i input.mp4 -map 0:v -map 0:a -map 0:s? -c copy output.mp4`

0:s? は、「字幕がある場合はマップし、字幕がない場合はスキップし、エラーは報告されない」ことを意味します。

一般的なピットの位置

-map を使用すると、FFmpeg はデフォルトでストリームを自動的に選択しなくなるため、必要なものをすべて書き出す必要があります。
-c copy は、トランスコーディングを行わずにカプセル化とコピーのみを行います。ターゲットコンテナが特定のエンコーディングをサポートしていない場合でも、失敗します。
複数の入力を入力するときに最もよくある間違いは、シリアル番号を入力することです。シリアル番号は -i の順序にのみ依存することに注意してください。
安定したスクリプトを作成したい場合は、まず ffprobe を作成し、次に手書きよりも安定した -map を生成します。

要約する

-map の中核は 1 つの文です。「どの入力から、どのタイプのストリームを取得し、どのストリームを取得するか」を FFmpeg に明確に指示します。

マスタリング後は、複数のオーディオトラック、複数の字幕、ファイル間の結合などの複雑なシーンを安定して処理できるようになり、「エクスポート結果が間違っているが原因がわからない」という問題を回避できます。