video-edit

動画編集

ffmpeg/ffprobe を直接実行して、ローカルで動画を編集します。ラッパースクリプトは不要です。

前提条件

ffmpeg（ffprobe を含む）をインストールします：

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install -y ffmpeg

# Verify
ffmpeg -version && ffprobe -version

クイックリファレンス

動画情報を取得する

ffprobe -v quiet -print_format json -show_format -show_streams video.mp4

トリミングする

ffmpeg -y -ss 00:00:30 -to 00:01:45 -i video.mp4 -c copy trimmed.mp4

クリップを結合する

# 1. Create a file list
printf "file '%s'\n" clip1.mp4 clip2.mp4 clip3.mp4 > list.txt

# 2. Concat with stream copy
ffmpeg -y -f concat -safe 0 -i list.txt -c copy joined.mp4

プラットフォーム向けにリサイズする

ffmpeg -y -i video.mp4 \
  -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black" \
  -c:a copy tiktok.mp4

再生速度を変更する

# 2x faster
ffmpeg -y -i video.mp4 -filter:v "setpts=0.5*PTS" -filter:a "atempo=2.0" fast.mp4

# 0.5x (slow motion)
ffmpeg -y -i video.mp4 -filter:v "setpts=2.0*PTS" -filter:a "atempo=0.5" slow.mp4

音声を抽出する

ffmpeg -y -i video.mp4 -vn -acodec libmp3lame audio.mp3

音声を差し替える

ffmpeg -y -i video.mp4 -i audio.mp3 -c:v copy -map 0:v:0 -map 1:a:0 -shortest output.mp4

圧縮する

ffmpeg -y -i video.mp4 -crf 23 -preset medium -c:a copy compressed.mp4

フォーマットを変換する

ffmpeg -y -i video.mov output.mp4

画像をオーバーレイする

# Logo in top-right corner
ffmpeg -y -i video.mp4 -i logo.png \
  -filter_complex "overlay=W-w-10:10" -c:a copy watermarked.mp4

プラットフォーム別プリセット

プラットフォーム	解像度	スケール＋パッドフィルター
TikTok	1080 x 1920	scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black
YouTube	1920 x 1080	scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:black
Instagram	1080 x 1350	scale=1080:1350:force_original_aspect_ratio=decrease,pad=1080:1350:(ow-iw)/2:(oh-ih)/2:black
Square	1080 x 1080	scale=1080:1080:force_original_aspect_ratio=decrease,pad=1080:1080:(ow-iw)/2:(oh-ih)/2:black
Twitter/X	1920 x 1080	scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:black

フィルターは次のように使用します：ffmpeg -y -i input.mp4 -vf "<filter>" -c:a copy output.mp4

ヒント

• 出力を確認なしで上書きするには、常に -y を使用します。
• カットや結合のみでよい場合は、-c copy を使用します（再エンコードなしで、非常に高速です）。
• CRF の値が小さいほど画質が高くなり、ファイルサイズも大きくなります。一般的な範囲は 18～28 で、デフォルトは 23 です。
• 詳しいレシピやフラグの説明については、references/operations.md を参照してください。