トラブルシューティング

FFmpegで変換した後にだけ音と映像がズレる問題を解決します。ストリームコピーが壊れたタイムスタンプをそのまま引き継ぐ理由、VFRソースが音ズレを起こす理由を解説し、再エンコード・+gentpsでのタイムスタンプ再生成・aresampleでの補正・固定フレームレート化で直します。

最初は合っているのに終わりに近づくほど音がズレる——それは一定のオフセットではなくドリフトです。クロックの不一致やVFRソースが原因となる理由、-itsoffsetでドリフトが直せない理由を解説し、FFmpegのaresample asyncで補正したうえで、固定サンプルレートやCFRで標準化します。

FFmpegで可変フレームレート(VFR)動画を固定フレームレート(CFR)に変換します。ffprobeでr_frame_rateとavg_frame_rateを比較してVFRの疑いを見分け、-fps_mode cfrでCFRに強制します。これは非推奨の-vsync cfrに代わるFFmpeg 8.xの方法で、多くの音ズレの根本原因を解消します。

WebのMP4が再生開始まで時間がかかる。原因はmoovアトムが末尾にあり再生開始が遅れること。FFmpegの-movflags +faststartで索引を先頭へ移動し、プログレッシブダウンロードとストリーミングを可能にする方法を解説。

FFmpegの「Could not find codec parameters」エラーを解決するガイド。よくある3つの原因——ストリームの破損・切れ、プローブ量の不足、特殊なコーデック——と、実行可能な解決策（analyzeduration/probesizeの拡大、ffprobeでの確認、再エンコード）を解説します。

libx264でよく出る「height not divisible by 2」「width not divisible by 2」エラーを解決する実践ガイド。yuv420pが幅・高さを偶数しか受け付けない理由を説明し、trunc で偶数に丸める方法、scale=-2 でアスペクト比を保つ方法、pad で偶数まで余白を足す方法という3つの即実行コマンドを紹介します。

FFmpegの「Invalid data found when processing input」エラーを切り分けて直す実践ガイド。よくある原因（途中で切れたダウンロード、メディアでないデータ、不完全なファイル、非対応コンテナ）を解説し、ffprobeでの確認、エラー許容での再multiplex、genptsによるタイムスタンプ修復、最終手段の再エンコードまで順に紹介します。

FFmpegの「Too many packets buffered for output stream」エラーを解決するガイド。一方のストリームのパケットが溜まってmuxキューが溢れる仕組み、-max_muxing_queue_sizeの引き上げ方、そしてコピーではなく再エンコードがインターリーブ問題を根本解決する理由を解説します。

FFmpegの「Unknown encoder 'libx264'」エラーを解決する実践ガイド。libx264を含まないビルドが原因である理由、ffmpeg -encodersと-codecsでの確認方法、OS別のフルビルド導入手順、x264が使えないときの代替エンコーダ（mpeg4・libvpx）まで解説します。

FFmpegの変換後に音声が出ない、音声トラックが消える問題を切り分けて直す実践ガイド。ffprobeでの確認、-mapのマップ漏れ、-anの混入、MP4×Opusなどコンテナ非対応コーデック、複数音声トラックで先頭のみ残る問題まで、原因別に解決コマンドを解説します。

FFmpegの「Permission denied」エラーを入力の読み取りと出力の書き込みで切り分け、Linux・macOS・Windows・Dockerの環境別に解決する手順を解説。ls -l / ls -ld での権限確認、chmod、書き込み可能ディレクトリへの出力、Dockerの --user 指定、Windowsのファイルロックまで網羅。

FFmpegで頻発する『non monotonically increasing dts to muxer』や invalid PTS/DTS エラーの原因を整理し、genptsでのタイムスタンプ再生成、負TSの補正、VFR→CFR化、setpts/asetptsでのリセットまで、再エンコード要否を切り分けて解決する実践ガイド。

iPhoneで撮った動画をWindows PCで開いたら『再生できない』『音だけ出る』『縦動画が横向きになる』。HEVC（H.265）コーデックや回転メタデータが原因の代表3パターンを解説し、ブラウザだけで直す方法とFFmpegコマンドの両方を示します。

iPhone・Androidで撮った動画には撮影場所のGPS座標が埋め込まれています。本記事ではexiftool・ffprobe・ブラウザツールで「何が埋め込まれているか」を確認し、SNS投稿前に位置情報・撮影日時・機材情報を安全に削除する方法を解説します。

FFmpegで発生する「moov atom not found」エラーの仕組みと対処法。MP4ファイル構造、faststart最適化、qt-faststart、untruncateによる修復手順をわかりやすく解説。

FFmpegで変換した動画・音声の音が出ない・無音になるときの原因を網羅。音声ストリームが含まれていない・-an指定・コーデック不一致・サンプルレート・チャンネル数の問題を原因別に解説。

FFmpegで「Unknown encoder」「Encoder not found」「codec not currently supported」が出るときの原因と解決策を解説。ビルドフラグ・代替コーデック・ライセンス問題まで網羅。

FFmpegでH.265/HEVCエンコードが失敗するときの原因と解決策。libx265が使えない環境での代替手段、プロファイル・レベル設定、Apple Siliconでのhevtag、メインプロファイル指定まで解説。

ffmpeg.wasmを使うWebアプリで「SharedArrayBuffer is not defined」「Cannot use SharedArrayBuffer」が出るときの原因と解決法。COOP/COEPヘッダー設定、Service Worker（coi-serviceworker）、各種サーバーでの設定方法を解説。

FFmpegで「No such file or directory」が出るときの原因を4パターンに分類して解説。パスのスペース・相対パス・拡張子ミスマッチ・glob展開の問題を即修正するコマンドと確認手順。

FFmpegでよく見るエラーの原因と解決策を即引きできるガイド。Unknown encoder、moov atom not found、height not divisible by 2、Invalid data found when processing input など10種類のエラーをコード・原因・解決コマンドセットで解説。