Windows に FFmpeg をインストールする方法:完全ガイド
Windows に FFmpeg をインストールするには、Windows ビルドを展開し、ffmpeg.exe を含むフォルダーを PATH に追加します。アーカイブ内にはバージョン付きのフォルダーがあるため、通常は
C:\FFmpeg\bin より深い階層になります。このガイドでは実際のパスを特定し、使用中のアカウントで FFmpeg を使えるようにして、短い動画の作成と検査で動作を確認します。
前提条件
x64 PC 上の Windows 11 と Windows PowerShell 5.1 を使用します。インターネット接続と、ZIP および展開後のファイルを保存する空き容量が必要です。インストール先はユーザープロファイル内で、変更するのはユーザー PATH だけです。管理者権限のターミナルは必要ありません。
以下のコマンドは、コマンドプロンプトではなく PowerShell に貼り付けてください。$bin を保持するため、インストール中は同じ PowerShell ウィンドウを開いたままにします。ブロックでエラーが報告されたら、そこで中止してください。これらのコマンドを貼り付けるためにスクリプト実行ポリシーを変更する必要はありません。
ZIP ビルドのインストール
手順 1:FFmpeg のダウンロード
FFmpeg 公式ダウンロードページを開き、「Windows builds from gyan.dev」のリンクをたどります。FFmpeg はソースコードを公開し、Gyan はコンパイル済みの Windows プログラムを提供しています。Gyan のビルドページで release builds を探し、ffmpeg-release-essentials.zip と、その隣にある .sha256 ファイルをダウンロードします。ffmpeg-release-essentials.zip.sha256 も含め、これらの名前のままダウンロードフォルダーに保存してください。ブラウザーでチェックサムがテキスト表示される場合は、そのファイル名でページをプレーンテキストファイルとして保存します。
ZIP のダウンロードが遅い場合は、ページの「mirror @ github」リンクをたどり、同じリリースの essentials ZIP を選びます。以下のコマンドを使うため、バージョン付き ZIP の名前を ffmpeg-release-essentials.zip に変更し、Gyan のビルドページにある同じバージョンのチェックサムを使用してください。
essentials ZIP には、ffmpeg、ffprobe、および後述の例で使う libx264 エンコーダーが含まれます。この ZIP は PowerShell 組み込みの展開機能で扱えるため、7-Zip は不要です。検証に使用したビルドは Gyan の 9.0.2-essentials_build です。アクセス時には、ダウンロードリンクから新しいリリースが提供される場合があります。
essentials ビルドは静的ビルドです。代わりに共有ビルドを選ぶ場合は、対応する FFmpeg DLL を実行ファイルと一緒に配置してください。「Full」は外部ライブラリを追加したもので、通常の H.264 エンコードに必要という意味ではありません。現在、Gyan は Windows 10 以降を必須としています。このガイドの対象は Windows 11 x64 で、古い Windows バージョンやネイティブ ARM64 ビルドは対象外です。
ZIP の検証と bin ディレクトリの特定
次のブロックを PowerShell に貼り付けてください。別の場所に保存した場合は、先に
$archive を変更します。このブロックは公開元のファイルと SHA-256 を照合し、%LOCALAPPDATA%\Programs\FFmpeg に展開して、実際の実行ファイルのディレクトリを
$bin に格納します。展開が中断されて残ったものも含め、既存の展開先は使用しません。インストール済みのファイルを上書きせず、別の展開先を選んでください。
$bin = & {
$ErrorActionPreference = 'Stop'
$archive = Join-Path $env:USERPROFILE 'Downloads\ffmpeg-release-essentials.zip'
$destination = Join-Path $env:LOCALAPPDATA 'Programs\FFmpeg'
if (Test-Path -LiteralPath $destination) {
throw 'The installation folder already exists. Choose a new destination.'
}
$expected = (Get-Content -Raw -LiteralPath "$archive.sha256").Trim()
$actual = (Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash
if ($expected -notmatch '^[0-9a-fA-F]{64}$' -or $actual -ne $expected) {
throw 'SHA-256 mismatch. Download the ZIP and its checksum again.'
}
Expand-Archive -LiteralPath $archive -DestinationPath $destination
$executables = @(Get-ChildItem -LiteralPath $destination -Filter ffmpeg.exe -File -Recurse)
if ($executables.Count -ne 1) {
throw 'Expected one ffmpeg.exe in the extracted archive.'
}
$executables[0].Directory.FullName
}
$bin
検証に使用した ZIP では、結果の末尾は
Programs\FFmpeg\ffmpeg-9.0.2-essentials_build\bin になります。最後の構成要素は bin で、そのフォルダーには
ffmpeg.exe と ffprobe.exe の両方が必要です。ZIP、外側の展開先フォルダー、実行ファイル名そのものを PATH に追加しないでください。
Get-FileHash は、ダウンロードしたバイト列を公開元のチェックサムと照合します。この照合で破損や不一致を検出できますが、一致しても公開元のファイルの信頼性を独立して証明するものではありません。Expand-Archive は、入れ子のディレクトリ構造を保って ZIP を展開します。
ユーザー PATH への FFmpeg の追加
PATH は、Windows がコマンドを探すディレクトリの一覧です。次のブロックは既存の項目を保持し、同一項目の重複を避けながら、$bin をユーザー PATH の末尾に追加します。システム PATH はすべてのアカウントに適用され、通常、変更には管理者権限が必要です。今回のインストールでは変更する必要はありません。
& {
$ErrorActionPreference = 'Stop'
if (-not $bin -or -not (Test-Path -LiteralPath (Join-Path $bin 'ffmpeg.exe') -PathType Leaf)) {
throw 'Run the extraction block successfully before changing PATH.'
}
$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
if (($userPath -split ';') -notcontains $bin) {
$updatedPath = (@($userPath, $bin) | Where-Object { $_ }) -join ';'
[Environment]::SetEnvironmentVariable('Path', $updatedPath, 'User')
}
}
これでアカウントの PATH が保存されますが、実行中のプログラムには反映されません。現在の PowerShell ウィンドウでは、プロセス PATH の先頭にもディレクトリを追加します。
$env:Path = "$bin;$env:Path"
子プロセスは親の環境を継承します。そのため、起動済みのターミナルやエディターで別のタブを開いても、古い PATH が残る場合があります。永続化を確認する前に、ターミナルアプリケーション全体を閉じ、スタートから開き直してください。古い環境が残る場合は、Windows からサインアウトして、再度サインインします。Microsoft の環境変数のドキュメントでは、プロセス、ユーザー、システムの各スコープを説明しています。上の一時的な先頭への追加では、意図的に今回のコピーを優先しています。新しくログインした環境では、結合された PATH 内で古いインストールが先に見つかることがあります。
インストールの確認
バージョンだけでなく、選択される実行ファイルも確認します。次のブロックを今実行し、ターミナルを開き直した後にも再度実行してください。
& {
$ErrorActionPreference = 'Stop'
Get-Command ffmpeg, ffprobe -All | Format-List CommandType, Name, Source
ffmpeg -version
if ($LASTEXITCODE -ne 0) { throw 'ffmpeg could not start.' }
ffprobe -version
if ($LASTEXITCODE -ne 0) { throw 'ffprobe could not start.' }
}
両方のパスが展開先の bin フォルダー内を指し、ビルドのバージョンが一致していることを確認します。同じ名前に複数の結果が表示される場合、PowerShell は最初のコマンドを選択します。エイリアスや関数が実行ファイルより優先されることもあります。
動画のエンコードと検査
PowerShell で、ダウンロードフォルダーなど、小さなテスト動画を作成するフォルダーに移動します。この例では一秒間のテストパターンを生成するため、入力映像や GPU は不要です。カレントディレクトリに ffmpeg-check.mp4 を書き込みます。明示的なファイル確認により、再実行時はエンコード前に停止します。-n も、FFmpeg による既存ファイルの上書きを防ぎます。再テストする場合は、そのファイルを別の場所に移すか、確認処理と両方のコマンドで別の出力名を指定してください。
& {
$ErrorActionPreference = 'Stop'
if (Test-Path -LiteralPath './ffmpeg-check.mp4') {
throw 'Output already exists. Move it aside or choose a new filename.'
}
ffmpeg -hide_banner -loglevel error -nostdin -n -f lavfi -i "testsrc2=size=320x180:rate=25" -t 1 -c:v libx264 -pix_fmt yuv420p "./ffmpeg-check.mp4"
if ($LASTEXITCODE -ne 0) { throw 'Encode failed. Check the error above before probing the output.' }
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height,pix_fmt:format=duration -of json "./ffmpeg-check.mp4"
if ($LASTEXITCODE -ne 0) { throw 'ffprobe could not read the output.' }
}
JSON には、h264、幅 320、高さ 180、ピクセル形式 yuv420p、約 1.000000 秒の長さが示されるはずです。これで、プログラムの起動だけでなく、実際の MP4 のエンコードと読み取りを確認できます。FFmpeg には上書き制御のドキュメントがあり、ffprobe のフィールド選択で結果を検査しやすくしています。
よくある問題のトラブルシューティング
FFmpeg が認識されない
フルパスを指定して実行ファイルが動くか確認します。元の PowerShell セッションでは、$bin にそのディレクトリが残っています。新しいセッションでは、展開時に表示されたパスを設定してください。
& {
$ErrorActionPreference = 'Stop'
& (Join-Path $bin 'ffmpeg.exe') -version
if ($LASTEXITCODE -ne 0) { throw 'The selected ffmpeg.exe could not start.' }
}
これが動くのに ffmpeg -version が動かない場合は、コマンドの検出を調べます。正しい bin の項目、ターミナルが継承した PATH、上記の Get-Command -All の結果を確認してください。「Unknown encoder」エラーは、FFmpeg 自体は起動したことを意味します。選択したビルドに指定したエンコーダーが含まれるか確認します。たとえば、ffmpeg -hide_banner -encoders を実行し、libx264 を探してください。
DLL が見つからないエラー
アーカイブ全体を新しいフォルダーに再展開し、PowerShell が実行している実行ファイルを確認します。共有ビルドには対応する DLL が必要です。.exe ファイルだけをコピーすると、必要な構成が失われます。異なるリリースの DLL を混在させたり、無関係なサイトから個別の DLL をダウンロードしたりしないでください。静的ビルドも Windows のシステムコンポーネントに依存します。最新の Visual C++ Redistributable のインストールは、特定の DLL がないというエラーの万能な解決策ではありません。そのビルドのドキュメントにあるランタイム要件に従ってください。
アクセス許可の問題
インストール先とテスト出力先には、使用中のアカウントで書き込めるフォルダーを使ってください。Program Files 配下やシステム PATH の変更時にアクセス拒否エラーが出ても、すべての変換を管理者として実行する理由にはなりません。管理対象の PC で実行ファイルのダウンロードや起動がブロックされる場合は、承認されたソフトウェアのインストール手順を使用してください。
ハードウェアアクセラレーションは別途確認
この例は CPU エンコードを使用します。ビルドに NVENC、QSV などのハードウェアコンポーネントが表示されても、その PC で使える証拠にはなりません。対応するハードウェアとドライバーも必要です。FFmpeg の-hwaccels のドキュメントで、この違いを説明しています。GPU エンコーダーの問題を診断する前に、ソフトウェアエンコードが動くことを確認してください。
パッケージマネージャーをすでに使用している場合
Gyan のビルドページには、Chocolatey、Scoop、WinGet のパッケージも掲載されています。これらは手動インストールの代替手段です。更新と削除には同じマネージャーを使い、パッケージがどのビルドをインストールするか確認してください。意図的に使い分ける場合を除き、両方の方法でインストールしたものを PATH に残さないでください。パッケージマネージャーのセットアップは、このガイドの対象外です。
FFmpeg の更新
この手動インストールを更新するには、新しい ZIP とチェックサムをダウンロードし、Programs\FFmpeg-new などの別の展開先で展開ブロックを再実行します。新しい $bin を使って PATH のブロックを実行し、新しい出力ファイル名でエンコードと検査を繰り返してください。新しいビルドが動くまでは、以前のフォルダーを残しておきます。
その後、スタートで「Edit environment variables for your account」を検索し、User variables の Path を編集します。新しい項目と無関係なすべての項目を残し、古い bin の項目だけを正確に指定して削除してください。ターミナルを再起動し、Get-Command を再確認してから、古いインストールを削除します。手動でインストールしたコピーをアンインストールするには、ユーザー PATH の項目を削除し、その後、展開したフォルダーを削除してください。
