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つの問題があります。

  1. プログレッシブダウンロード(ダウンロードしながらの再生)の開始が遅れる:HTTP の Range リクエスト(ファイルの一部だけを取る要求)に対応したサーバーなら、プレーヤーは末尾の moov を先に取りに行くので、全体のダウンロードを待たずに再生できます。ただし、そのぶん再生の開始が遅れます。
  2. 録画中にクラッシュすると壊れる: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 のほうがクラッシュに強いです。

関連記事