FFmpeg ビデオプロダクションガイド
FFmpegは動画・音声処理に不可欠なツールです。このスキルでは、Remotionプロジェクト向けの一般的な操作をカバーします。
クイックリファレンス
GIFからMP4(Remotion互換)
ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \
-vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" output.mp4
各フラグの理由:
-movflags faststart- メタデータを先頭に移動してWebストリーミング対応-pix_fmt yuv420p- ほとんどのプレイヤーとの互換性を確保scale=trunc(...)- 偶数サイズに強制(多くのコーデックで必要)
動画リサイズ
# 1920x1080に変更(アスペクト比維持、黒帯追加)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" output.mp4
# 1920x1080に変更(クロップして画面いっぱい)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" output.mp4
# 幅指定、高さ自動
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
動画圧縮
# 高品質、小さめファイル(CRF 23はデフォルト、低いほど高品質)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4
# Webプレビュー向け積極的圧縮
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4
# ファイルサイズ指定(例:60秒動画で約10MB = 約1.3Mbps)
ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4
音声抽出
# MP3に抽出
ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3
# AACに抽出
ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a
# WAVに抽出(無圧縮)
ffmpeg -i input.mp4 -vn output.wav
音声フォーマット変換
# M4AからMP3(ElevenLabsボイスサンプル用)
ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3
# WAVからMP3
ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3
# 音量調整
ffmpeg -i input.mp3 -filter:a "volume=1.5" output.mp3
トリミング/カット
# タイムスタンプから指定時間だけ切り出し(推奨、信頼性高)
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4
# タイムスタンプ間を切り出し
ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4
# ストリームコピー(高速だがカット点でフレーム欠損の可能性)
# ソースにキーフレームが多い場合のみ使用
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4
注意: トリミングには再エンコードを推奨します。ストリームコピー(-c copy)は、シークポイントがキーフレームと合わない場合、動画が無音で欠損することがあります。
速度変更
# 2倍速(動画と音声)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" output.mp4
# 0.5倍速(スローモーション)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" output.mp4
# 動画のみ(音声なし)
ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -an output.mp4
動画結合
# ファイルリスト作成
echo "file 'clip1.mp4'" > list.txt
echo "file 'clip2.mp4'" >> list.txt
echo "file 'clip3.mp4'" >> list.txt
# 結合(同じコーデック/解像度)
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4
# 再エンコードして結合(異なるソース)
ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4
フェードイン/アウト追加
# 最初の1秒フェードイン、最後の1秒フェードアウト(30fps動画)
ffmpeg -i input.mp4 -vf "fade=t=in:st=0:d=1,fade=t=out:st=9:d=1" -c:a copy output.mp4
# 音声フェード
ffmpeg -i input.mp4 -af "afade=t=in:st=0:d=1,afade=t=out:st=9:d=1" -c:v copy output.mp4
動画情報取得
# 再生時間、解像度、コーデック情報
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4
# 全情報
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
Remotion固有のパターン
Remotion向け動画速度調整
FFmpegとRemotionのplaybackRateの使い分け:
| シナリオ | FFmpegを使用 | Remotionを使用 |
|---|---|---|
| 一定速度(1.5倍、2倍) | どちらでも可 | ✅ より簡単 |
| 極端な速度(4倍超、0.25倍未満) | ✅ より信頼性高 | 問題が発生する可能性あり |
| 可変速度(時間とともに加速) | ✅ プリプロセス | 複雑な回避策が必要 |
| 完璧な音声同期が必要 | ✅ 確実 | 通常は問題なし |
| デモをナレーションのタイミングに合わせる | ✅ 事前計算 | 実行時調整 |
Remotionの制限: playbackRateは定数である必要があります。playbackRate={interpolate(frame, [0, 100], [1, 5])}のような動的補間は、Remotionがフレームを独立して評価するため正常に動作しません。
# デモをシーンに合わせて高速化(例:60秒のデモを20秒に = 3倍速)
ffmpeg -i demo-raw.mp4 \
-filter_complex "[0:v]setpts=0.333*PTS[v];[0:a]atempo=3.0[a]" \
-map "[v]" -map "[a]" \
public/demos/demo-fast.mp4
# スローモーションで強調(0.5倍速)
ffmpeg -i action.mp4 \
-filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" \
-map "[v]" -map "[a]" \
public/demos/action-slow.mp4
# 音声なしで高速化(画面録画によく使用)
ffmpeg -i demo.mp4 -filter:v "setpts=0.5*PTS" -an public/demos/demo-2x.mp4
# タイムラプス効果(10倍速、音声削除)
ffmpeg -i long-demo.mp4 -filter:v "setpts=0.1*PTS" -an public/demos/timelapse.mp4
速度係数の計算:
- X秒の動画をY秒のシーンに収める:
速度 = X / Y - setpts倍率 =
1 / 速度(例:3倍速 = setpts=0.333*PTS) - atempo値 =
速度(例:3倍速 = atempo=3.0)
極端な速度(2倍超の音声): atempoフィルタを連鎖(各フィルタは0.5~2.0の範囲に制限):
# 4倍速音声
-filter_complex "[0:a]atempo=2.0,atempo=2.0[a]"
# 8倍速音声
-filter_complex "[0:a]atempo=2.0,atempo=2.0,atempo=2.0[a]"
Remotion用デモ録画の準備
# 標準的な1080p、30fps、Remotion対応
ffmpeg -i raw-recording.mp4 \
-vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,fps=30" \
-c:v libx264 -crf 18 -preset slow \
-c:a aac -b:a 192k \
-movflags faststart \
public/demos/demo.mp4
画面録画からRemotionアセットへ
# iPhone/iPadからの録画(通常60fps、可変解像度)
ffmpeg -i iphone-recording.mov \
-vf "scale=1920:-2,fps=30" \
-c:v libx264 -crf 20 \
-an \
public/demos/mobile-demo.mp4
GIFの一括変換
for f in assets/*.gif; do
ffmpeg -i "$f" -movflags faststart -pix_fmt yuv420p \
-vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" \
"public/demos/$(basename "$f" .gif).mp4"
done
よくある問題
「Height not divisible by 2」
スケールフィルタを追加: -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2"
動画がブラウザで再生できない
以下を使用: -movflags faststart -pix_fmt yuv420p -c:v libx264
速度変更後に音声がずれる
atempo付きのfilter_complexを使用: -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]"
ファイルが大きすぎる
CRFを上げる(23→28)か、解像度を下げる
品質ガイドライン
| ユースケース | CRF | プリセット | 備考 |
|---|---|---|---|
| アーカイブ/マスター | 18 | slow | 最高品質、大容量ファイル |
| プロダクション | 20-22 | medium | 良いバランス |
| Web/プレビュー | 23-25 | fast | 小容量ファイル |
| 下書き/簡易 | 28+ | veryfast | 高速エンコード |
プラットフォーム別出力最適化
Remotionで動画をレンダリング(通常out/video.mp4)した後、FFmpegを使用して各配信プラットフォーム向けに最適化します。
ワークフロー統合
Remotionレンダリング(マスター) FFmpeg最適化 プラットフォームアップロード
↓ ↓ ↓
out/video.mp4 ────────→ out/video-youtube.mp4 ───→ YouTube
────────→ out/video-twitter.mp4 ───→ Twitter/X
────────→ out/video-linkedin.mp4 ───→ LinkedIn
────────→ out/video-web.mp4 ───→ Webサイト埋め込み
YouTube(推奨設定)
YouTubeはすべてを再エンコードするため、高品質でアップロード:
# YouTube最適化(1080p)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset slow -crf 18 \
-profile:v high -level 4.0 \
-bf 2 -g 30 \
-c:a aac -b:a 192k -ar 48000 \
-movflags +faststart \
out/video-youtube.mp4
# YouTube Shorts(縦型1080x1920)
ffmpeg -i out/video.mp4 \
-vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" \
-c:v libx264 -crf 18 -c:a aac -b:a 192k \
out/video-shorts.mp4
Twitter/X
Twitterには厳しい制限があります:最大140秒、512MB、1920x1200:
# Twitter最適化(高速アップロード向け15MB目標)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 24 \
-profile:v main -level 3.1 \
-vf "scale='min(1280,iw)':'min(720,ih)':force_original_aspect_ratio=decrease" \
-c:a aac -b:a 128k -ar 44100 \
-movflags +faststart \
-fs 15M \
out/video-twitter.mp4
# ファイルサイズと再生時間を確認
ffprobe -v error -show_entries format=duration,size -of csv=p=0 out/video-twitter.mp4
LinkedInはMP4(AAC音声)、最大10分を推奨:
# LinkedIn最適化
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 22 \
-profile:v main \
-vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" \
-c:a aac -b:a 192k -ar 48000 \
-movflags +faststart \
out/video-linkedin.mp4
Webサイト/埋め込み(高速読み込み最適化)
# Web最適化MP4(小容量、プログレッシブ読み込み)
ffmpeg -i out/video.mp4 \
-c:v libx264 -preset medium -crf 26 \
-profile:v baseline -level 3.0 \
-vf "scale=1280:720" \
-c:a aac -b:a 128k \
-movflags +faststart \
out/video-web.mp4
# WebM代替(より良い圧縮、広いブラウザサポート)
ffmpeg -i out/video.mp4 \
-c:v libvpx-vp9 -crf 30 -b:v 0 \
-vf "scale=1280:720" \
-c:a libopus -b:a 128k \
-deadline good \
out/video-web.webm
GIF(プレビュー/サムネイル用)
# 高品質GIF(最初の5秒)
ffmpeg -i out/video.mp4 -t 5 \
-vf "fps=15,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
out/preview.gif
# 小容量GIF
ffmpeg -i out/video.mp4 -t 3 \
-vf "fps=10,scale=320:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
out/preview-small.gif
プラットフォーム要件クイックリファレンス
| プラットフォーム | 最大解像度 | 最大サイズ | 最大時間 | 音声 |
|---|---|---|---|---|
| YouTube | 8K | 256GB | 12時間 | AAC 48kHz |
| Twitter/X | 1920x1200 | 512MB | 140秒 | AAC 44.1kHz |
| 4096x2304 | 5GB | 10分 | AAC 48kHz | |
| Instagram フィード | 1080x1350 | 4GB | 60秒 | AAC 48kHz |
| Instagram Reels | 1080x1920 | 4GB | 90秒 | AAC 48kHz |
| TikTok | 1080x1920 | 287MB | 10分 | AAC |
全プラットフォーム一括エクスポート
#!/bin/bash
# save as: export-all-platforms.sh
INPUT="out/video.mp4"
# YouTube(高品質)
ffmpeg -i "$INPUT" -c:v libx264 -preset slow -crf 18 \
-c:a aac -b:a 192k -movflags +faststart \
out/video-youtube.mp4
# Twitter(圧縮)
ffmpeg -i "$INPUT" -c:v libx264 -crf 24 \
-vf "scale='min(1280,iw)':'-2'" \
-c:a aac -b:a 128k -movflags +faststart \
out/video-twitter.mp4
# LinkedIn
ffmpeg -i "$INPUT" -c:v libx264 -crf 22 \
-c:a aac -b:a 192k -movflags +faststart \
out/video-linkedin.mp4
# Web埋め込み(小容量)
ffmpeg -i "$INPUT" -c:v libx264 -crf 26 \
-vf "scale=1280:720" \
-c:a aac -b:a 128k -movflags +faststart \
out/video-web.mp4
echo "エクスポート完了:"
ls -lh out/video-*.mp4
エラーハンドリング
動画処理でよくあるエラーと修正方法:
# FFmpegが成功したか確認
ffmpeg -i input.mp4 -c:v libx264 output.mp4 && echo "成功" || echo "失敗:入力ファイルを確認してください"
# 出力ファイルが再生可能か検証
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 output.mp4
# 詳細なエラー情報を取得
ffmpeg -v error -i input.mp4 -f null - 2>&1 | head -20
よくある障害への対応
| エラー | 原因 | 修正方法 |
|---|---|---|
| 「No such file」 | 入力パスが間違い | パスを確認、スペースには引用符を使用 |
| 「Invalid data」 | 入力ファイルが破損 | ソースを再ダウンロードまたは再録画 |
| 「height not divisible by 2」 | 奇数サイズ | truncを使用したスケールフィルタを追加 |
| 「encoder not found」 | コーデックがない | フルコーデック版のFFmpegをインストール |
| 出力が0バイト | サイレント失敗 | 完全なffmpeg出力を確認してエラーを特定 |
フィードバックとコントリビューション
このスキルに不足している情報や改善点がある場合:
- コマンドが足りない? 必要な内容を教えてください
- エラーを見つけた? 何が問題か教えてください
- コントリビューションしたい? 以下の手順をお手伝いします:
- このスキルを改善する
- github.com/digitalsamba/claude-code-video-toolkit にPRを作成する
「このスキルを改善してください」とお伝えいただければ、.claude/skills/ffmpeg/SKILL.md の更新を案内します。