moov atom not found とは
MP4ファイルは、「atom(アトム)」または「box(ボックス)」と呼ばれるブロックがいくつも集まってできています。中でも特に重要なのが次の atom です。
mdat(Media Data atom):動画・音声のデータそのものmoov(Movie atom):ファイルの目次にあたるインデックス情報(タイムスタンプ、サンプルの位置など)
moov がないと、プレーヤーもFFmpegもファイルを再生・処理できません。
エラー例:
moov atom not found
Invalid data found when processing input
なぜ moov がファイル末尾にあるのか
FFmpegは何も指定しないと、エンコードが終わってから moov をファイルの末尾に書き込みます。エンコードが終わるまでフレーム数や各フレームの大きさがわからず、moov の中身と大きさが確定しないためです。
[デフォルト構造]
ftyp | mdat(巨大な映像・音声データ) | moov(インデックス)
この並びには、次の2つの問題があります。
- プログレッシブダウンロード(ダウンロードしながらの再生)の開始が遅れる:HTTP の Range リクエスト(ファイルの一部だけを取る要求)に対応したサーバーなら、プレーヤーは末尾の
moovを先に取りに行くので、全体のダウンロードを待たずに再生できます。ただし、そのぶん再生の開始が遅れます。 - 録画中にクラッシュすると壊れる:
moovを書き込む前にプロセスが終了すると、moovのない壊れたファイルになります。
moov を先頭に置く:-movflags faststart
-movflags faststart を付けると moov がファイルの先頭に置かれます。-c copy を付ければ、既存のMP4を再エンコードせずに作り直せます。
ffmpeg -i input.mp4 -c copy -movflags faststart output_fast.mp4
音声や字幕のトラックが複数あるファイルは -map 0 を加えます(付けないと、映像・音声・字幕が1本ずつしか残りません)。
moov が先頭に来るので、ダウンロードの途中でも再生を始められます。
[faststart構造]
ftyp | moov(インデックス) | mdat(映像・音声データ)
エンコード時に faststart を指定する
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -c:a aac -movflags faststart output.mp4
qt-faststart で既存ファイルを最適化
qt-faststart は同じことをする別のツールです。gyan.dev の Windows 版ビルドには入っていませんが、ffmpeg -c copy -movflags faststart で同じ結果になります。
録画クラッシュで壊れたファイルの修復
録画中にクラッシュして moov がないファイルは、FFmpegだけでは直せません。同じ機器・同じ設定で撮った正常なファイルがあれば、オープンソースの untrunc で moov を作り直せる場合があります。
untrunc ok.mp4 broken.mp4
ok.mp4 は見本にする正常なファイル、broken.mp4 は壊れたファイルです。うまくいくと broken_fixed.mp4 ができます。
フラグメント化MP4で耐クラッシュ性を上げる
録画に使うなら、フラグメント化MP4が向いています。先頭に空の moov を1回だけ書き、そのあとは映像・音声を短い区切り(moof と mdat の組)ごとに追記していく形式です。
ffmpeg -i input.mp4 -c copy \
-movflags frag_keyframe+empty_moov \
-frag_duration 4000000 \
output_frag.mp4
frag_keyframe:キーフレームごとにフラグメント(区切り)を作りますempty_moov:ファイルの先頭に空のmoovを置きます-frag_duration 4000000:1つのフラグメントを長くても4秒で区切ります(単位はマイクロ秒)。frag_keyframeも付けているので、それより前にキーフレームが来ればそこで区切られます
この形式なら、途中でクラッシュしても部分的には再生できます(HLS/DASHに近い構造です)。-movflags +hybrid_fragmented を使うと、フラグメント化MP4として録画し、書き込みが終わった時点で通常のMP4にします(faststart とは併用できません)。途中で切れたフラグメント化MP4は、ffmpeg -i broken.mp4 -c copy fixed.mp4 で通常のMP4にできます。
実測: 処理時間とサイズ
計測したコマンドは次のとおりです。
ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4
| 項目 | 実測値 |
|---|---|
| 処理時間 | 0.49 秒 |
| 出力サイズ | 353.29 MB |
計測環境: Core i9-14900KF(32スレッド)/FFmpeg 8.1(gyan.dev)/素材は 1920x1080・30fps・120秒・351.4 MB の映像(Big Buck Bunny をループ、CC BY 3.0)に、128 kb/s の AAC 音声を1本加えた MP4 で、全体で 353.29 MB です。2026-09-05 に計測しました。生データはデータセットで公開しています。
なぜ 0.49 秒で終わるのか
faststart は再エンコードせず、パケットを書き戻して索引を先頭へ移すだけなので、この 353 MB のファイルで約 0.5 秒で終わります。ほぼ同じ素材の再エンコードは約 28 秒でした。
付け忘れても、後から付けられます(このファイルでは 0.49 秒)。
MP4のatom構造を確認する方法
ffprobe で atom の構造を調べられます。
ffprobe -v trace -i input.mp4 2>&1 | grep -E "type:'(ftyp|moov|mdat)'"
ffprobe -v trace -i input.mp4 2>&1 | Select-String "type:'(ftyp|moov|mdat)'"
moov が mdat より前にあれば、すでに先頭にあります。
よくある質問
Q: moov atom not found のファイルを再エンコードできないか?
できません。moov がないと、FFmpegはファイルのどこにフレームがあるのかわからないので、読み込みの段階で失敗します。先に修復ツールで直す必要があります。
Q: -movflags faststart は常に使うべきか?
Webや配信に使うなら付けてください。手元で再生するだけなら不要です。ただし録画に使うなら、frag_keyframe+empty_moov のほうがクラッシュに強いです。