ffmpegとは、動画と音声を読み込み、加工して別の形式へ書き出す、コマンドで動かす変換の道具です。

  • ffmpeg のインストールの道(公式は源のコードだけを配り、実行の形は OS ごとの配り手から入れる)と、入った後の確かめ方
  • ffmpeg の使い方:形式の変換・切り出し・音の取り出し・字幕の焼き付けの書き方を表で
  • 当社の AI の席と CI が ffmpeg で実際に詰まった所(確かめの誤読・libass の欠け・apt の IPv6・配信の取り出しが返らない)と、その直し方

当社は、短い動画の書き出しや長い動画の音の取り出し、配信の確かめを、AIエージェントの席と CI の job に任せています。その下で毎回動いているのが ffmpeg です。この頁は、ffmpeg の公式の文書に書いてある定義と書き方を、当社の席が実際に撃って止まった記録と並べたものです。

ffmpeg のインストール:公式が配るのは源のコードだけ

ffmpeg の公式の配布の頁は「FFmpeg only provides source code」と書き、すぐ使える実行の形(コンパイル済みのもの)は外の配り手の頁へ案内しています(https://ffmpeg.org/download.html 2026-11-12 に確認)。自分でコンパイルしないなら、OS ごとに次のどれかから入れます。

OS公式の配布の頁が案内している入れ方入れた後に見る所
Linux(Debian・Ubuntu)
各ディストリビューションの公式のパッケージ(Debian は deb-multimedia の版も案内)
使いたい符号器や濾過器が組み込まれているか(下の確かめ方)
Linux(Fedora・RHEL)
RPM Fusion のパッケージ
同上
Linux(静的な版)
BtbN の GitHub の配布
道(PATH)に置いた物が呼ばれているか
Windows
gyan.dev の版か BtbN の版(EXE)
展開した bin を PATH に通したか
macOS
evermeet.cx の静的な版
道(PATH)に置いた物が呼ばれているか

出典: FFmpeg「Download FFmpeg」https://ffmpeg.org/download.html (2026-11-12 に確認)。

大事なのは、同じ「ffmpeg」でも、配り手と組み立て方で中に入っている部品が違うことです。字幕を焼く濾過器や MP3 の符号器が入っているかは、入れた後に自分の機体で確かめます。

インストールできたかの確かめ方:-encoders と -filters は別の一覧

ffmpeg には、組み込まれている部品の一覧を出す撃ち方があります。名前が似ていて取り違えやすいので、公式の文書の言葉で並べます。

撃ち方何を出すか(公式の文書)こういう時に使う
ffmpeg -version
版を出す
道に ffmpeg が在るか、どの組み立てが呼ばれているか
ffmpeg -encoders
使える符号器(エンコーダ)を全部出す
MP3 で書き出せるか(libmp3lame)など、書き出しの形を確かめる
ffmpeg -filters
使える libavfilter の濾過器(フィルタ)を出す
字幕を焼く subtitles・ass など、加工の部品を確かめる
ffmpeg -codecs
libavcodec が知っている codec を全部出す
形式そのものを扱えるかをざっと見る

出典: FFmpeg Documentation「ffmpeg」https://ffmpeg.org/ffmpeg.html (2026-11-12 に確認)。

当社の AI の席の「始める前の機体の確かめ」の手順に、ffmpeg -filters | grep libmp3lame と書かれていました。libmp3lame は符号器なので濾過器の一覧には出ません。そのため、-encoders には A....D libmp3lame と出る(=入っている)機体で、確かめは「MISSING」と誤って出しました(社の実測 2026-11-03)。符号器は ffmpeg -encoders | grep libmp3lame で見ます。

逆に、本当に欠けていた例もあります。別の機体の ffmpeg には libass が組み込まれておらず、字幕を焼く段がそもそも撃てませんでした(画像を作る PIL も入っていませんでした)(社の実測 2026-10-25)。公式の文書は、subtitles の濾過器は libass で字幕を描き、使うには ffmpeg を --enable-libass で組み立てる必要がある、と書いています(https://ffmpeg.org/ffmpeg-filters.html 2026-11-12 に確認)。字幕を焼く仕事を任せる前に、ffmpeg -filters | grep subtitles で在るかを見ておくのが早道です。

ffmpeg の使い方:よく使う書き方

ffmpeg の基本の形は ffmpeg [全体のオプション] {[入力のオプション] -i 入力} ... {[出力のオプション] 出力} です。オプションは、どのファイルの前に置くかで「入力に効く」か「出力に効く」かが変わります(公式の文書)。

したい事書き方の例オプションの意味(公式の文書)
形式を変える
ffmpeg -i in.mov out.mp4
-i は入力のファイル(URL も可)
作り直さずに切り出す
ffmpeg -ss 開始 -i in.mp4 -t 長さ -c copy out.mp4
-ss を入力の前に置くとその位置へ飛ぶ。-t は長さを限る。-c copy は流れを作り直さない
音だけを取り出す
ffmpeg -i in.mp4 -vn out.m4a
-vn は出力から映像を外す
音を消す
ffmpeg -i in.mp4 -an -c:v copy out.mp4
-an は出力から音を外す
字幕を焼き込む
ffmpeg -i in.mp4 -vf subtitles=sub.srt out.mp4
-vf は映像に濾過器を掛ける。subtitles は libass が要る
聞かずに上書きする
ffmpeg -y -i in.mp4 out.mp4
-y は出力のファイルを聞かずに上書きする

出典: FFmpeg Documentation「ffmpeg」https://ffmpeg.org/ffmpeg.html ・「FFmpeg Filters Documentation」https://ffmpeg.org/ffmpeg-filters.html (どちらも 2026-11-12 に確認)。

AI の席に撃たせる時は -y を付けておくと、上書きの問いで止まって待ち続けることがありません。ASS 形式の字幕だけを焼くなら、libavcodec と libavformat を要らない ass の濾過器も使えます(公式の文書)。

当社の AI の席と CI が ffmpeg で回した記録

場面起きた事どうしたか日付
機体の確かめ
-filters で libmp3lame を探し、入っているのに「MISSING」と出た
符号器は -encoders で見る
2026-11-03
別の機体の確かめ
ffmpeg に libass が無く、字幕を焼く段が撃てない(PIL も無い)
欠けとして挙げた
2026-10-25
CI の integration の「Install ffmpeg」段
apt が IPv6 で Network is unreachable になり exit 100
job 側で apt を IPv4 に固定し、撃ち直しを足した
2026-11-06
本番の動画の配信(HLS)の確かめ
CDN から 480p・720p の両方を ffmpeg で全尺解けた
配信が最後まで読めることの確かめに使った
2026-11-08
縦の短い動画の書き出し
札と字幕を 1 本ずつ焼き、15.00 秒・21.30 秒・18.27 秒の縦動画を作った
1 本ずつ焼いて確かめる形で回した
2026-11-10・11-11
当社の長い動画の音の取り出し
HLS の URL から取り出す処理が 3 本、約 2 時間返らずに固まった
1 本ずつ止め、時間の上限を付けて撃ち直すよう指示した
2026-11-12

出典: 社の実測(日付は各行)。

CI で apt install ffmpeg が IPv6 で落ちた時は、job 側で IPv4 に固定する

当社の CI(GitHub Actions を GCP の使い捨ての作業員・arm64 で回す形)では、integration の job の「Install ffmpeg」段で apt が packages.cloud.google.com へ IPv6 でつなごうとして Network is unreachable になり、apt が exit 100 で落ちました(社の実測 2026-11-06)。

この組は merge queue の先頭の前で落ちたので、列が組み直され、後ろで緑に通っていた組まで撃ち直しになりました(社の実測 2026-11-06)。一つの段の失敗が、関係の無い変更の待ちを延ばした形です。merge queue の列の動き方は merge queue の頁に書いています。

直したのは job の側です。apt に Acquire::ForceIPv4 と Acquire::Retries を渡し、apt-get update を 3 回まで撃ち直す形にして通しました。作業員の像(イメージ)には触っていません(社の実測 2026-11-06)。作業員を自前で持つ時の考え方は self-hosted runner の頁にまとめています。

# job の中で ffmpeg を入れる段(形の例)
for i in 1 2 3; do
  sudo apt-get -o Acquire::ForceIPv4=true -o Acquire::Retries=<回数> update && break
done
sudo apt-get -o Acquire::ForceIPv4=true install -y ffmpeg

配信の URL から ffmpeg で読む時は、時間の上限を付ける

本番の動画の配信(HLS)を入れ替えた時の確かめで、当社は CDN から 480p と 720p の両方を ffmpeg で頭から終わりまで解き、どちらも全尺読めることを確かめました(社の実測 2026-11-08)。ffmpeg の -i は手元のファイルだけでなく URL も受けるので、配信が最後まで読めるかの確かめに使えます。

一方で、同じ「URL から読む」使い方で固まった事もあります。当社の長い動画の音を HLS の URL(-i https://…/hls/…)から ffmpeg で取り出す処理が 3 本、約 2 時間返りませんでした。50 分の音を取り出すにしても長すぎる時間です(社の実測 2026-11-12)。見張りの席がこれを見つけ、1 本ずつ止めて、取り出しに時間の上限(-rw_timeout・timeout)を付けて撃ち直すよう指示しました(社の実測 2026-11-12)。撃ち直した後の結果は、この頁を書いた時点ではまだ出ていません。

公式の文書では、rw_timeout は全部のプロトコルが受けるオプションで、「(ネットワークの) 読み書きが終わるのを待つ最大の時間」をマイクロ秒で指定します(https://ffmpeg.org/ffmpeg-protocols.html 2026-11-12 に確認)。単位が秒ではない点に気を付けます。付けないと、相手が応えなくなった時に失敗を返さず待ち続ける形になりえます。

# 形の例:読み書きの待ちに上限を付けて、配信の URL から音だけを取り出す
ffmpeg -rw_timeout <マイクロ秒> -i "https://example.com/hls/master.m3u8" -vn -c:a copy out.m4a

取り出した音を文字に起こす流れは 動画の文字起こし の頁に書いています。

縦の短い動画に札と字幕を焼く時は、1 本ずつ焼く

当社の短い動画を作る AI の席は、話す声と人物の動画を作った後、白い札と字幕を ffmpeg で 1 本ずつ焼いて、15.00 秒・21.30 秒・18.27 秒の縦の動画を書き出しました(社の実測 2026-11-10・2026-11-11)。何本もまとめて流さず 1 本ずつ焼くので、どの 1 本で崩れたかがすぐ分かります。

この段は、上の libass の欠けがあると撃てません(社の実測 2026-10-25)。字幕を焼く席を新しい機体で動かす時は、先に -filters で subtitles を確かめてから任せます。人物の動画と声の作り方は HeyGen の使い方と MiniMax の API の頁、収録から書き出しまでの全体の流れは 動画の編集を AI に任せる頁にあります。

よくある質問

ffmpeg はどこからダウンロードしてインストールする?

公式は源のコードだけを配り、実行の形は外の配り手を案内しています。Linux は各ディストリビューションのパッケージ、Windows は gyan.dev か BtbN の版、macOS は evermeet.cx の静的な版です(https://ffmpeg.org/download.html 2026-11-12 に確認)。

ffmpeg がインストールできたかはどう確かめる?

ffmpeg -version で呼べるかを見て、使う部品を一覧で確かめます。符号器(libmp3lame など)は -encoders、濾過器(subtitles など)は -filters で見ます。当社は濾過器の一覧で符号器を探し、入っている物を「MISSING」と誤って出しました(社の実測 2026-11-03)。

ffmpeg で字幕を焼く濾過器が使えないのはなぜ?

subtitles の濾過器は libass で字幕を描くので、--enable-libass で組み立てた ffmpeg でないと使えません(https://ffmpeg.org/ffmpeg-filters.html 2026-11-12 に確認)。libass の入った組み立ての ffmpeg に入れ替えます。

ffmpeg の使い方で、作り直さずに動画を切るには?

入力の前に -ss で開始の位置、-t で長さを指定し、-c copy を付けると流れを作り直さずに書き出します(https://ffmpeg.org/ffmpeg.html 2026-11-12 に確認)。

ffmpeg が URL を読んだまま終わらない時は?

読み書きの待ちに上限を付ける -rw_timeout(単位はマイクロ秒)を入力の前に置きます(https://ffmpeg.org/ffmpeg-protocols.html 2026-11-12 に確認)。当社は HLS の URL からの音の取り出しが約 2 時間返らず、時間の上限を付けて撃ち直すことにしました(社の実測 2026-11-12)。

出典

  1. FFmpeg Documentation「ffmpeg」https://ffmpeg.org/ffmpeg.html (2026-11-12 に確認)
  2. FFmpeg「Download FFmpeg」https://ffmpeg.org/download.html (2026-11-12 に確認)
  3. FFmpeg「FFmpeg Protocols Documentation」https://ffmpeg.org/ffmpeg-protocols.html (2026-11-12 に確認)
  4. FFmpeg「FFmpeg Filters Documentation」https://ffmpeg.org/ffmpeg-filters.html (2026-11-12 に確認)
  5. 社の実測 2026-10-25・2026-11-03・2026-11-06・2026-11-08・2026-11-10・2026-11-11・2026-11-12