本文へ移動
FFmpegの使い方

FFmpegでM3U8をMP4に変換する方法:コマンドラインガイド

HTTP Live Streaming(HLS)は.m3u8プレイリストを使い、動画を小さな断片に分けて配信します。通常の[名前を付けて保存]では1つの動画ファイルになりません。オープンソースのFFmpegなら、プレイリストを解析してセグメントを取得し、互換性の高いMP4にまとめられます。

VODの保存、配信データの調査、ライブ配信の記録など、FFmpegにはHLSを扱うための機能があります。このガイドでは基本の変換、音声の扱い、復号、プロトコル設定を順に説明し、画質を落とさずに取り出す方法を示します。

FFmpegを使う理由

オンラインのM3U8ダウンローダーの多くは、FFmpegに画面を付けたものです。FFmpegを直接使えば、HTTPヘッダー、音声トラック、再多重化の方法を細かく指定でき、不要な再エンコードによる画質低下を避けられます。

M3U8をMP4に変換する基本コマンド

最も簡単なのは、FFmpegにプレイリストのURLを直接渡す方法です。FFmpegをインストール済みなら、ターミナルで次を実行します。

ffmpeg -i "https://example.com/stream/playlist.m3u8" -c copy output.mp4

コマンドの各部分を説明します。

  • -i "url" は入力を指定します。URLに?token=123のようなクエリがある場合、シェルで解釈されないよう引用符で囲みます。
  • -c copy は映像と音声をそのままコピーして再多重化します。動画を再エンコードしないため画質は変わらず、処理速度は主にダウンロード速度で決まります。
  • output.mp4 は出力ファイルです。.mp4拡張子により、取得したH264/AACデータをMP4コンテナに格納します。

ライブ配信とタイムアウトへの対応

基本コマンドをライブ配信に使うと、FFmpegはセグメントを継続して取得します。録画時間を決めるには、-tで秒数またはHH:MM:SS形式の時間を指定します。

ffmpeg -i "https://live-server.com/live.m3u8" -t 00:30:00 -c copy live_capture.mp4

接続の中断に備える

ライブ配信ではセグメントが欠けたり、一時停止したりします。短い通信障害で即座に失敗しないよう、-reconnect関連のオプションを追加できます。

ネットワークエラー時に再接続するには、次のコマンドを使います。

ffmpeg -reconnect 1 -reconnect_at_eof 1 -reconnect_streamed 1 -reconnect_delay_max 5 -i "https://live-server.com/live.m3u8" -c copy output.mp4

AES-128で暗号化された配信を復号する

HLSはAES-128暗号化に対応します。プレイリストに#EXT-X-KEY:METHOD=AES-128,URI="key.bin"がある場合、鍵のURIにアクセスできればFFmpegが自動的に復号します。

鍵に認証や特定のCookieが必要な場合は、HTTP 403 Forbiddenエラーになります。必要なHTTPヘッダーやCookieは-headersでFFmpegに渡せます。

ffmpeg -headers "Cookie: session_id=abc123xyz" -i "https://protected-site.com/video.m3u8" -c copy output.mp4
注意:FFmpegはWidevine、FairPlay、PlayReadyなどのDRM(SAMPLE-AESで示されることがあります)を回避できません。復号できるのは標準のAES-128方式で、鍵にアクセスできる場合です。

音声の同期ずれを直す

元のTSセグメントで表示時刻(PTS)が少しずれていると、MP4への再多重化後に映像と音声の同期が徐々にずれることがあります。

-bsf:a aac_adtstoascビットストリームフィルターは、ADTS形式のAAC音声をMPEG-4 Audio Specific Configuration形式に変換します。これによりQuickTimeやブラウザーでの再生問題が解消する場合があります。

ffmpeg -i "https://example.com/playlist.m3u8" -c copy -bsf:a aac_adtstoasc output.mp4

映像・音声トラックを指定する

マスターM3U8には360p、720p、1080pなど複数の解像度が含まれます。FFmpegにそのまま渡すと、最初または最高画質のストリームが選ばれることがあります。目的のトラックを確実に選ぶには-mapを使います。

ファイルをダウンロードせずに利用可能なストリームを見るには、次を実行します。

ffmpeg -i "https://example.com/master.m3u8"

Program 1、Program 2などの行を探します。例えばProgram 2を取得するには、次のように指定します。

ffmpeg -i "https://example.com/master.m3u8" -map p:2 -c copy output.mp4

別の方法として、マスタープレイリストをテキストエディターやDevToolsで開き、目的のメディアプレイリスト(例:1080p.m3u8)のURLを見つけてFFmpegに直接渡せます。

ローカルのM3U8ファイルをまとめて処理する

.m3u8と.tsセグメントをローカルに保存済みなら、FFmpegで結合できます。.m3u8のあるディレクトリで次を実行します。

ffmpeg -allowed_extensions ALL -i local_playlist.m3u8 -c copy output.mp4

ローカルのプレイリストを読む際は-allowed_extensions ALLが必要な場合があります。FFmpegは既定では、テキスト内で参照された任意のローカルファイルへのアクセスを制限します。