動画制作のための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
速度変更後に音声がずれる
filter_complexをatempoとともに使用: -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はAACオーディオ付きのMP4を推奨、最大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
# 保存先: 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 の更新をガイドします。