CRITICAL GUIDELINES
Windows File Path Requirements
MANDATORY: Always Use Backslashes on Windows for File Paths
When using Edit or Write tools on Windows, you MUST use backslashes (\) in file paths, NOT forward slashes (/).
クイックリファレンス
| タスク | コマンド |
|---|---|
| グリーンスクリーン除去 | -vf "chromakey=0x00FF00:0.3:0.1" |
| ブルースクリーン除去 | -vf "chromakey=0x0000FF:0.3:0.1" |
| LUT適用 | -vf "lut3d=cinematic.cube" |
| カラーカーブ | -vf "curves=preset=vintage" |
| 彩度調整 | -vf "eq=saturation=1.5" |
| 色相シフト | -vf "hue=h=30" |
| ホワイトバランス | -vf "colortemperature=6500" |
このスキルを使用するタイミング
以下のカラーマニピュレーション操作に使用します:
- グリーン/ブルースクリーンの背景除去
- LUTカラーグレーディングの適用
- 色補正と強調
- シネマティックな色味の作成
- HDR/SDR変換
- コンポジット用のカラーキーイング
FFmpeg カラーグレーディング & クロマキー (2025)
FFmpegを使用したカラーマニピュレーション、グリーンスクリーン除去、LUTグレーディング、および高度なカラーエフェクトの完全ガイド。
グリーンスクリーン (クロマキー) 除去
基本クロマキー
# グリーンスクリーン除去(標準グリーン 0x00FF00)
ffmpeg -i foreground.mp4 -i background.mp4 \
-filter_complex "[0:v]chromakey=0x00FF00:0.3:0.1[fg];[1:v][fg]overlay" \
-c:v libx264 -crf 18 output.mp4
# パラメータ:
# - color: キー色 (16進数 0xRRGGBB)
# - similarity: キー色との類似度 (0.0-1.0、低いほど正確)
# - blend: エッジのソフトネス (0.0-1.0、高いほどエッジが柔らかくなる)
クロマキーパラメータ調整
# タイトキー(クリーンなエッジ、グリーンフリンジが残る可能性あり)
ffmpeg -i green_screen.mp4 -i background.jpg \
-filter_complex "[0:v]chromakey=0x00FF00:0.1:0.0[fg];[1:v][fg]overlay" \
output.mp4
# ルースキー(すべてのグリーンを除去、被写体を削る可能性あり)
ffmpeg -i green_screen.mp4 -i background.jpg \
-filter_complex "[0:v]chromakey=0x00FF00:0.5:0.2[fg];[1:v][fg]overlay" \
output.mp4
# バランス(推奨開始点)
ffmpeg -i green_screen.mp4 -i background.jpg \
-filter_complex "[0:v]chromakey=0x00FF00:0.3:0.1[fg];[1:v][fg]overlay" \
output.mp4
ブルースクリーン除去
# ブルースクリーン除去
ffmpeg -i blue_screen.mp4 -i background.mp4 \
-filter_complex "[0:v]chromakey=0x0000FF:0.3:0.1[fg];[1:v][fg]overlay" \
output.mp4
# クロマブルー(一般的な放送用ブルー)
ffmpeg -i footage.mp4 -i background.mp4 \
-filter_complex "[0:v]chromakey=0x0047AB:0.3:0.15[fg];[1:v][fg]overlay" \
output.mp4
サンプルグリーンスクリーン色
| 名前 | 16進数 | ユースケース |
|---|---|---|
| ピュアグリーン | 0x00FF00 | デジタルグリーンスクリーン |
| クロマグリーン | 0x00B140 | プロフェッショナル映画/TV |
| ライトグリーン | 0x90EE90 | 明るい背景 |
| ピュアブルー | 0x0000FF | デジタルブルースクリーン |
| クロマブルー | 0x0047AB | プロフェッショナル放送 |
デスピルを使用した高度なクロマキー
グリーンスピル除去(被写体へのグリーン反射):
# デスピルでグリーンスクリーン除去
ffmpeg -i green_screen.mp4 -i background.mp4 \
-filter_complex "\
[0:v]chromakey=0x00FF00:0.3:0.1,\
colorbalance=gs=-0.1:gm=-0.1:gh=-0.1[fg];\
[1:v][fg]overlay" \
output.mp4
# hueフィルターを使用したより強力なデスピル
ffmpeg -i green_screen.mp4 -i background.mp4 \
-filter_complex "\
[0:v]chromakey=0x00FF00:0.3:0.1,\
hue=s=0.9[fg];\
[1:v][fg]overlay" \
output.mp4
Colorkey フィルター(透明化)
Colorkeyは、コンポジットではなく実際の透明度(アルファチャンネル)を作成します:
# 透明な動画を作成(アルファ付きWebM)
ffmpeg -i green_screen.mp4 \
-vf "colorkey=0x00FF00:0.3:0.1" \
-c:v libvpx-vp9 -pix_fmt yuva420p \
output_transparent.webm
# 透明なPNGシーケンスを作成
ffmpeg -i green_screen.mp4 \
-vf "colorkey=0x00FF00:0.3:0.1" \
frame_%04d.png
Colorkey vs Chromakey
| 機能 | colorkey | chromakey |
|---|---|---|
| 出力 | アルファチャンネル | コンポジット |
| フォーマット | アルファ対応が必要 | 任意のフォーマット |
| 用途 | マスクの作成 | 直接コンポジット |
| フォーマット例 | WebM、PNG、ProRes 4444 | MP4、MKVなど |
LUT カラーグレーディング
3D LUTの適用
# .cube LUTファイルの適用
ffmpeg -i input.mp4 \
-vf "lut3d=cinematic.cube" \
-c:v libx264 -crf 18 output.mp4
# .3dl LUTの適用
ffmpeg -i input.mp4 \
-vf "lut3d=film_look.3dl" \
output.mp4
# 補間方法の指定
ffmpeg -i input.mp4 \
-vf "lut3d=lut.cube:interp=trilinear" \
output.mp4
LUT補間方法
| 方法 | 品質 | 速度 |
|---|---|---|
| nearest | 最低 | 最速 |
| trilinear | 良好 | 高速 |
| tetrahedral | 最高 | 低速 |
# 高品質LUT適用
ffmpeg -i input.mp4 \
-vf "lut3d=film.cube:interp=tetrahedral" \
-c:v libx264 -crf 18 output.mp4
オリジナルとLUTのブレンド
# 50% LUT強度
ffmpeg -i input.mp4 \
-filter_complex "\
[0:v]split[a][b];\
[a]lut3d=cinematic.cube[graded];\
[b][graded]blend=all_expr='A*0.5+B*0.5'" \
output.mp4
# colorbalanceを使用した可変LUT強度
ffmpeg -i input.mp4 \
-vf "lut3d=lut.cube,colorbalance=rs=0:gs=0:bs=0" \
output.mp4
人気のLUTスタイル
外部LUTなしで一般的なルックを作成:
# ティール&オレンジ(大作映画風)
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=0.1:gs=-0.1:bs=-0.2:rm=0.05:gm=-0.05:bm=-0.1:rh=0.1:gh=-0.05:bh=-0.15" \
output.mp4
# ビンテージ/レトロ
ffmpeg -i input.mp4 \
-vf "curves=preset=vintage,eq=saturation=0.8:contrast=1.1" \
output.mp4
# ハイコントラストシネマティック
ffmpeg -i input.mp4 \
-vf "eq=contrast=1.2:brightness=-0.05:saturation=1.1,unsharp=5:5:0.8" \
output.mp4
# 低彩度/ブリーチバイパス
ffmpeg -i input.mp4 \
-vf "eq=saturation=0.5:contrast=1.3:brightness=-0.02" \
output.mp4
# 暖色/ゴールデンアワー
ffmpeg -i input.mp4 \
-vf "colortemperature=5000,eq=saturation=1.2:brightness=0.05" \
output.mp4
# 寒色/ムーンライト
ffmpeg -i input.mp4 \
-vf "colortemperature=8000,eq=saturation=0.9:brightness=-0.05" \
output.mp4
カラーカーブ
プリセットカーブ
# ビンテージルック
ffmpeg -i input.mp4 -vf "curves=preset=vintage" output.mp4
# クロスプロセス(フィルム現像効果)
ffmpeg -i input.mp4 -vf "curves=preset=cross_process" output.mp4
# ネガティブ画像
ffmpeg -i input.mp4 -vf "curves=preset=negative" output.mp4
# コントラスト増加
ffmpeg -i input.mp4 -vf "curves=preset=strong_contrast" output.mp4
# 明るく
ffmpeg -i input.mp4 -vf "curves=preset=lighter" output.mp4
# 暗く
ffmpeg -i input.mp4 -vf "curves=preset=darker" output.mp4
# リニアコントラスト
ffmpeg -i input.mp4 -vf "curves=preset=linear_contrast" output.mp4
# ミディアムコントラスト
ffmpeg -i input.mp4 -vf "curves=preset=medium_contrast" output.mp4
カスタムカーブ
# Sカーブによるコントラスト(RGB)
ffmpeg -i input.mp4 \
-vf "curves=all='0/0 0.25/0.20 0.5/0.5 0.75/0.80 1/1'" \
output.mp4
# シャドウを持ち上げ、ハイライトを下げる
ffmpeg -i input.mp4 \
-vf "curves=all='0/0.05 0.5/0.5 1/0.95'" \
output.mp4
# チャンネルごとのカーブ(R、G、B)
ffmpeg -i input.mp4 \
-vf "curves=r='0/0 0.5/0.6 1/1':g='0/0 0.5/0.5 1/1':b='0/0 0.5/0.4 1/1'" \
output.mp4
# 潰れた黒(フィルムルック)
ffmpeg -i input.mp4 \
-vf "curves=all='0/0.03 0.15/0.15 0.5/0.5 0.85/0.85 1/1'" \
output.mp4
カラーバランス
colorbalance フィルター
# 暖色ハイライト、寒色シャドウ
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=-0.1:gs=-0.05:bs=0.1:rh=0.1:gh=0.05:bh=-0.1" \
output.mp4
# パラメータ:
# rs/gs/bs = 赤/緑/青 シャドウ (-1 ~ 1)
# rm/gm/bm = 赤/緑/青 中間調 (-1 ~ 1)
# rh/gh/bh = 赤/緑/青 ハイライト (-1 ~ 1)
一般的なカラーバランスプリセット
# オレンジ&ティール(シネマティック)
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=0.15:bs=-0.15:rh=0.1:bh=-0.1" \
output.mp4
# 全体的に暖かく
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=0.1:rm=0.05:rh=0.1:bs=-0.05:bm=-0.03:bh=-0.05" \
output.mp4
# 寒色シャドウ、暖色ハイライト(分割調色)
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=-0.1:bs=0.1:rh=0.15:bh=-0.1" \
output.mp4
色相と彩度
hue フィルター
# 色相を30度回転
ffmpeg -i input.mp4 -vf "hue=h=30" output.mp4
# 彩度を上げる
ffmpeg -i input.mp4 -vf "hue=s=1.5" output.mp4
# 彩度を下げる(脱色)
ffmpeg -i input.mp4 -vf "hue=s=0.5" output.mp4
# 明るさを調整
ffmpeg -i input.mp4 -vf "hue=b=0.1" output.mp4
# アニメーション色相回転
ffmpeg -i input.mp4 \
-vf "hue=h=t*36" \
output.mp4 # 10秒ごとに完全回転
eq フィルター(包括的)
# 完全な色調整
ffmpeg -i input.mp4 \
-vf "eq=contrast=1.1:brightness=0.05:saturation=1.2:gamma=1.1" \
output.mp4
# eqパラメータ:
# contrast: 0-2 (デフォルト 1)
# brightness: -1 ~ 1 (デフォルト 0)
# saturation: 0-3 (デフォルト 1)
# gamma: 0.1-10 (デフォルト 1)
# gamma_r/gamma_g/gamma_b: チャンネルごとのガンマ
ホワイトバランス
colortemperature フィルター(FFmpeg 5.1以降)
# 暖色に(低い色温度)
ffmpeg -i input.mp4 \
-vf "colortemperature=temperature=5000" \
output.mp4
# 寒色に(高い色温度)
ffmpeg -i input.mp4 \
-vf "colortemperature=temperature=8000" \
output.mp4
# ニュートラルな昼光
ffmpeg -i input.mp4 \
-vf "colortemperature=temperature=6500" \
output.mp4
手動ホワイトバランス
# colorbalanceを使用したホワイトバランス
# 青みがかった色味を補正(暖かさを追加)
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=0.1:rm=0.05:bs=-0.1:bm=-0.05" \
output.mp4
# 黄/オレンジ色味を補正(青を追加)
ffmpeg -i input.mp4 \
-vf "colorbalance=rs=-0.1:rm=-0.05:bs=0.1:bm=0.05" \
output.mp4
色空間変換
SDR色空間
# BT.601 を BT.709 に変換
ffmpeg -i input.mp4 \
-vf "colorspace=bt709:iall=bt601-6-625:fast=1" \
-c:v libx264 -crf 18 \
output.mp4
# 色空間メタデータの強制
ffmpeg -i input.mp4 \
-color_primaries bt709 -color_trc bt709 -colorspace bt709 \
-c:v libx264 -crf 18 output.mp4
HDRからSDRへのトーンマッピング
# 基本HDR to SDR (BT.2020/PQ を BT.709 に)
ffmpeg -i hdr_input.mp4 \
-vf "zscale=t=linear:npl=100,format=gbrpf32le,\
zscale=p=bt709,tonemap=tonemap=hable:desat=0,\
zscale=t=bt709:m=bt709:r=tv,format=yuv420p" \
-c:v libx264 -crf 18 sdr_output.mp4
# HDR10 to SDR 高品質
ffmpeg -i hdr10_input.mp4 \
-vf "zscale=t=linear:npl=100,format=gbrpf32le,\
zscale=p=bt709,tonemap=tonemap=reinhard:param=0.4:desat=0,\
zscale=t=bt709:m=bt709,format=yuv420p" \
-c:v libx264 -crf 18 output.mp4
トーンマッピングアルゴリズム
| アルゴリズム | 特性 |
|---|---|
| none | クリッピングのみ |
| clip | SDR範囲へのハードクリップ |
| linear | 線形スケール |
| gamma | ガンマカーブ |
| reinhard | ソフトロールオフ、自然 |
| hable | フィルム調、John Hable |
| mobius | Sカーブ、スムーズ |
選択的カラーマニピュレーション
カラーアイソレーション(選択的脱色)
# 赤色のみ保持、残りを脱色(Sin City効果)
ffmpeg -i input.mp4 \
-vf "hue=s=0,\
split[a][b];\
[a]hue=s=0[bw];\
[b]colorkey=0xFF0000:0.3:0.1[red];\
[bw][red]overlay" \
output.mp4
# selectivecolorを使用した特定の色範囲の分離
# 注:より制御するにはcolorchannelmixerを使用
colorchannelmixer
# 適切な輝度重みでグレースケールに変換
ffmpeg -i input.mp4 \
-vf "colorchannelmixer=.3:.59:.11:0:.3:.59:.11:0:.3:.59:.11" \
output.mp4
# セピア調
ffmpeg -i input.mp4 \
-vf "colorchannelmixer=.393:.769:.189:0:.349:.686:.168:0:.272:.534:.131" \
output.mp4
# 赤と青のチャンネルを入れ替え
ffmpeg -i input.mp4 \
-vf "colorchannelmixer=0:0:1:0:0:1:0:0:1:0:0:0" \
output.mp4
# 赤を強調、青を低減
ffmpeg -i input.mp4 \
-vf "colorchannelmixer=1.2:0:0:0:0:1:0:0:0:0:0.8:0" \
output.mp4
プロフェッショナルグレーディングチェーン
フィルムエミュレーション
# 35mmフィルムルック
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=1.1:saturation=0.95:gamma=1.05,\
curves=preset=cross_process,\
colorbalance=rs=0.05:bh=-0.05,\
noise=c0s=3:c1s=3:c0f=t:c1f=t,\
unsharp=3:3:0.5" \
-c:v libx264 -crf 18 film_look.mp4
# Kodak Portra風
ffmpeg -i input.mp4 \
-vf "\
eq=saturation=0.9:contrast=1.05,\
colorbalance=rs=0.1:gs=-0.02:rm=0.05:gm=-0.02,\
curves=r='0/0.02 1/0.98':g='0/0 1/1':b='0/0.02 1/0.95'" \
output.mp4
# Fuji Film風
ffmpeg -i input.mp4 \
-vf "\
eq=saturation=1.1:contrast=1.05,\
colorbalance=gs=0.05:bs=0.08:gm=0.02:bm=0.05,\
curves=g='0/0.02 1/1'" \
output.mp4
モダンシネマティック
# 大作映画 オレンジ&ティール
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=1.15:saturation=1.1:brightness=-0.02,\
colorbalance=rs=0.12:gs=-0.04:bs=-0.15:rh=0.08:bh=-0.12,\
curves=all='0/0.02 0.5/0.5 1/0.98',\
unsharp=5:5:0.6" \
-c:v libx264 -crf 18 cinematic.mp4
# ムーディー/Darkシネマティック
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=1.2:brightness=-0.08:saturation=0.85,\
colorbalance=bs=0.1:bm=0.05:gh=-0.05,\
curves=all='0/0.05 0.5/0.45 1/0.9'" \
output.mp4
# ハイキーブライト
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=0.9:brightness=0.1:saturation=0.9:gamma=0.85,\
colorbalance=rs=0.05:gs=0.02:bs=0.02" \
output.mp4
ミュージックビデオスタイル
# ネオン/サイバーパンク
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=1.3:saturation=1.5:bright=0.05,\
hue=h=10,\
colorbalance=bs=0.3:bm=0.2:rs=-0.2:rm=-0.1" \
output.mp4
# ヴェイパーウェイブ
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=1.1:saturation=0.7:gamma=1.2,\
colorchannelmixer=.5:.5:0:0:.5:.5:0:0:.5:.5:0:0,\
noise=c0s=2:c1s=2" \
output.mp4
# ドリームポップ
ffmpeg -i input.mp4 \
-vf "\
eq=contrast=0.85:brightness=0.08:saturation=0.8:gamma=0.9,\
curves=all='0/0.05 0.5/0.55 1/0.9',\
unsharp=3:3:0.3" \
output.mp4
バッチ処理と自動化
複数ファイルの処理
# Bashスクリプトを使用したバッチLUT適用
for f in *.mp4; do
ffmpeg -i "$f" \
-vf "lut3d=film.cube" \
-c:v libx264 -crf 18 "graded_$f"
done
# Windowsバッチ(PowerShell)
Get-ChildItem *.mp4 | ForEach-Object {
ffmpeg -i $_.Name `
-vf "lut3d=film.cube" `
-c:v libx264 -crf 18 "graded_$($_.Name)"
}
マルチパスグレーディング
# パイプを使用したマルチパス(中間ファイルなし)
ffmpeg -i input.mp4 \
-vf "curves=preset=vintage" \
-f mp4 - |
ffmpeg -i - \
-vf "colorbalance=rs=0.1:bs=-0.1" \
-c:v libx264 -crf 18 final_output.mp4
# ノイズ除去後グレーディング
ffmpeg -i noisy_input.mp4 \
-vf "hqdn3d=4:3:6:4,curves=preset=medium_contrast" \
-c:v libx264 -crf 18 clean_graded.mp4
トラブルシューティング
一般的な問題
| 問題 | 解決策 |
|---|---|
| グリーンフリンジ | similarityを下げるか、デスピルフィルターを追加 |
| 被写体の穴 | similarityを上げる |
| エッジのギザギザ | blend値を上げる |
| 色のバンディング | 高ビット深度で出力(-pix_fmt yuv420p10le) |
| パフォーマンスの問題 | 解像度を下げるか、-preset fastを使用 |
品質のヒント
# 高品質グリーンスクリーン(10ビット)
ffmpeg -i green_screen.mp4 -i background.mp4 \
-filter_complex "[0:v]chromakey=0x00FF00:0.3:0.1[fg];[1:v][fg]overlay" \
-c:v libx264 -crf 18 -pix_fmt yuv420p10le \
-profile:v high10 output.mp4
# ロスレス出力(ProRes)
ffmpeg -i input.mp4 \
-vf "lut3d=film.cube" \
-c:v prores_ks -profile:v 4 \
-pix_fmt yuv422p10le graded.mov
フィルターリファレンス
| フィルター | 説明 | 例 |
|---|---|---|
| chromakey | グリーン/ブルースクリーン除去 | chromakey=0x00FF00:0.3:0.1 |
| colorkey | 透明マスクを作成 | colorkey=0x00FF00:0.3:0.1 |
| lut3d | 3D LUTを適用 | lut3d=film.cube:interp=tetrahedral |
| curves | カラーカーブを調整 | curves=preset=vintage |
| colorbalance | シャドウ/中間調/ハイライトを調整 | colorbalance=rs=0.1:bs=-0.1 |
| colorchannelmixer | チャンネルミキシング | colorchannelmixer=.3:.59:.11 |
| hue | 色相/彩度/明るさ | hue=h=30:s=1.5 |
| eq | コントラスト/彩度/ガンマ | eq=contrast=1.1:saturation=1.2 |
| colortemperature | 色温度ホワイトバランス | colortemperature=temperature=5000 |
| zscale | HDR色空間変換 | zscale=t=linear:npl=100 |
| tonemap | HDRトーンマッピング | tonemap=tonemap=hable |
補足
- LUTファイル:
lut3dで.cube、.3dl、.datファイルを使用可能 - 色空間: BT.601/BT.709/BT.2020変換には
colorspace、HDRにはzscale - 処理速度: リアルタイム処理には、解像度を下げるか、
-preset ultrafastを使用 - 品質: 最終出力には、16ビット浮動小数点処理とロスレスコーデックを推奨