メディア処理スキル

FFmpeg と ImageMagick コマンドラインツールを使用して、ビデオ、オーディオ、画像の変換、最適化、ストリーミング、操作タスクを処理します。

このスキルを使う場面

以下の場合に使用してください:

• メディア形式の変換（ビデオ、オーディオ、画像）
• コーデックでのビデオエンコーディング（H.264、H.265、VP9、AV1）
• 画像処理（リサイズ、クロップ、エフェクト、ウォーターマーク）
• ビデオからのオーディオ抽出
• ストリーミングマニフェストの作成（HLS/DASH）
• サムネイルとプレビューの生成
• メディアファイルのバッチ処理
• ファイルサイズと品質の最適化
• フィルターとエフェクトの適用
• 合成画像またはビデオの作成

ツール選択ガイド

FFmpeg: ビデオ/オーディオ処理

FFmpeg を使用:

• ビデオエンコーディング、変換、トランスコーディング
• オーディオ抽出、変換、ミキシング
• ライブストリーミング（RTMP、HLS、DASH）
• ビデオフィルター（スケール、クロップ、回転、オーバーレイ）
• ハードウェアアクセラレーテッドエンコーディング
• メディアファイル検査（ffprobe）
• フレーム抽出、連結
• コーデック選択と最適化

ImageMagick: 画像処理

ImageMagick を使用:

• 画像形式変換（PNG、JPEG、WebP、GIF）
• リサイズ、クロップ、変換
• バッチ画像処理（mogrify）
• ビジュアルエフェクト（ぼかし、シャープ、セピア）
• テキストオーバーレイとウォーターマーク
• 画像合成とモンタージュ
• 色調調整、フィルター
• サムネイル生成

決定マトリックス

タスク	ツール	理由
ビデオエンコーディング	FFmpeg	ネイティブビデオコーデックサポート
オーディオ抽出	FFmpeg	ダイレクトストリーム操作
画像リサイズ	ImageMagick	静止画に最適化
バッチ画像	ImageMagick	一括編集向け mogrify
ビデオサムネイル	FFmpeg	フレーム抽出組み込み
GIF作成	FFmpeg または ImageMagick	ビデオソースは FFmpeg、画像は ImageMagick
ストリーミング	FFmpeg	ライブストリーミングプロトコル
画像エフェクト	ImageMagick	リッチフィルターライブラリ

インストール

macOS

brew install ffmpeg imagemagick

Ubuntu/Debian

sudo apt-get install ffmpeg imagemagick

Windows

# winget を使用
winget install ffmpeg
winget install ImageMagick.ImageMagick

# またはバイナリをダウンロード
# FFmpeg: https://ffmpeg.org/download.html
# ImageMagick: https://imagemagick.org/script/download.php

インストール確認

ffmpeg -version
ffprobe -version
magick -version
# または
convert -version

クイックスタート例

ビデオ変換

# 形式を変換（ストリームをコピー、高速）
ffmpeg -i input.mkv -c copy output.mp4

# H.264 で再エンコード
ffmpeg -i input.avi -c:v libx264 -crf 22 -c:a aac output.mp4

# ビデオを 720p にリサイズ
ffmpeg -i input.mp4 -vf scale=-1:720 -c:a copy output.mp4

オーディオ抽出

# オーディオを抽出（再エンコードなし）
ffmpeg -i video.mp4 -vn -c:a copy audio.m4a

# MP3 に変換
ffmpeg -i video.mp4 -vn -q:a 0 audio.mp3

画像処理

# 形式を変換
magick input.png output.jpg

# アスペクト比を保持してリサイズ
magick input.jpg -resize 800x600 output.jpg

# 正方形サムネイルを作成
magick input.jpg -resize 200x200^ -gravity center -extent 200x200 thumb.jpg

バッチ画像リサイズ

# すべての JPEG を 800px 幅にリサイズ
mogrify -resize 800x -quality 85 *.jpg

# 別ディレクトリに出力
mogrify -path ./output -resize 800x600 *.jpg

ビデオサムネイル

# 5 秒地点のフレームを抽出
ffmpeg -ss 00:00:05 -i video.mp4 -vframes 1 -vf scale=320:-1 thumb.jpg

HLS ストリーミング

# HLS プレイリストを生成
ffmpeg -i input.mp4 \
  -c:v libx264 -preset fast -crf 22 -g 48 \
  -c:a aac -b:a 128k \
  -f hls -hls_time 6 -hls_playlist_type vod \
  playlist.m3u8

画像ウォーターマーク

# コーナーにウォーターマークを追加
magick input.jpg watermark.png -gravity southeast \
  -geometry +10+10 -composite output.jpg

一般的なワークフロー

Web 用ビデオの最適化

# 良好な圧縮率の H.264
ffmpeg -i input.mp4 \
  -c:v libx264 -preset slow -crf 23 \
  -c:a aac -b:a 128k \
  -movflags +faststart \
  output.mp4

レスポンシブ画像の作成

# 複数のサイズを生成
for size in 320 640 1024 1920; do
  magick input.jpg -resize ${size}x -quality 85 "output-${size}w.jpg"
done

ビデオセグメントを抽出

# 1:30 から 3:00 まで（精度のため再エンコード）
ffmpeg -i input.mp4 -ss 00:01:30 -to 00:03:00 \
  -c:v libx264 -c:a aac output.mp4

バッチ画像最適化

# PNG を最適化された JPEG に変換
mogrify -path ./optimized -format jpg -quality 85 -strip *.png

ビデオ GIF 作成

# パレット付き高品質 GIF
ffmpeg -i input.mp4 -vf "fps=15,scale=640:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif

画像ぼかしエフェクト

# ガウシアンぼかし
magick input.jpg -gaussian-blur 0x8 output.jpg

高度なテクニック

マルチパスビデオエンコーディング

# パス 1（分析）
ffmpeg -y -i input.mkv -c:v libx264 -b:v 2600k -pass 1 -an -f null /dev/null

# パス 2（エンコーディング）
ffmpeg -i input.mkv -c:v libx264 -b:v 2600k -pass 2 -c:a aac output.mp4

ハードウェアアクセラレーテッドエンコーディング

# NVIDIA NVENC
ffmpeg -hwaccel cuda -i input.mp4 -c:v h264_nvenc -preset fast -crf 22 output.mp4

# Intel QuickSync
ffmpeg -hwaccel qsv -c:v h264_qsv -i input.mp4 -c:v h264_qsv output.mp4

複雑な画像パイプライン

# リサイズ、クロップ、ボーダー、調整
magick input.jpg \
  -resize 1000x1000^ \
  -gravity center \
  -crop 1000x1000+0+0 +repage \
  -bordercolor black -border 5x5 \
  -brightness-contrast 5x10 \
  -quality 90 \
  output.jpg

ビデオフィルターチェーン

# スケール、ノイズ除去、ウォーターマーク
ffmpeg -i video.mp4 -i logo.png \
  -filter_complex "[0:v]scale=1280:720,hqdn3d[v];[v][1:v]overlay=10:10" \
  -c:a copy output.mp4

画像からのアニメーション GIF

# 遅延付きで作成
magick -delay 100 -loop 0 frame*.png animated.gif

# サイズを最適化
magick animated.gif -fuzz 5% -layers Optimize optimized.gif

メディア分析

ビデオプロパティを検査

# 詳細 JSON 出力
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

# 解像度を取得
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height \
  -of csv=s=x:p=0 input.mp4

画像情報

# 基本情報
identify image.jpg

# 詳細形式
identify -verbose image.jpg

# カスタム形式
identify -format "%f: %wx%h %b\n" image.jpg

パフォーマンスティップ

1. 品質制御に CRF を使用 - ビデオではビットレートより優れている
2. 可能な限りストリームをコピー - -c copy で再エンコードを避ける
3. ハードウェアアクセラレーション - GPU エンコーディングは 5～10 倍高速
4. 適切なプリセット - 速度と圧縮のバランスを取る
5. mogrify でバッチ処理 - インプレース画像処理
6. メタデータを削除 - -strip でファイルサイズを削減
7. プログレッシブ JPEG - -interlace Plane で Web ロード改善
8. メモリを制限 - 大規模バッチでのクラッシュを防止
9. サンプルでテスト - バッチ前に設定を確認
10. 並列処理 - GNU Parallel で複数ファイルを処理

リファレンスドキュメント

references/ の詳細ガイド:

• ffmpeg-encoding.md - ビデオ/オーディオコーデック、品質最適化、ハードウェアアクセラレーション
• ffmpeg-streaming.md - HLS/DASH、ライブストリーミング、アダプティブビットレート
• ffmpeg-filters.md - ビデオ/オーディオフィルター、複雑なフィルターグラフ
• imagemagick-editing.md - 形式変換、エフェクト、変換
• imagemagick-batch.md - バッチ処理、mogrify、並列操作
• format-compatibility.md - 形式サポート、コーデック推奨

一般的なパラメータ

FFmpeg ビデオ

• -c:v - ビデオコーデック（libx264、libx265、libvpx-vp9）
• -crf - 品質（0～51、低いほど良い、23=デフォルト）
• -preset - 速度/圧縮（ultrafast から veryslow）
• -b:v - ビデオビットレート（例：2M、2500k）
• -vf - ビデオフィルター

FFmpeg オーディオ

• -c:a - オーディオコーデック（aac、mp3、opus）
• -b:a - オーディオビットレート（例：128k、192k）
• -ar - サンプルレート（44100、48000）

ImageMagick ジオメトリ

• 800x600 - 内部にフィット（アスペクト比を保持）
• 800x600! - 正確なサイズを強制
• 800x600^ - 埋める（クロップ可能）
• 800x - 幅のみ
• x600 - 高さのみ
• 50% - スケール割合

トラブルシューティング

FFmpeg "Unknown encoder"

# 利用可能なエンコーダーを確認
ffmpeg -encoders | grep h264

# コーデックライブラリをインストール
sudo apt-get install libx264-dev libx265-dev

ImageMagick "not authorized"

# ポリシーファイルを編集
sudo nano /etc/ImageMagick-7/policy.xml
# <policy domain="coder" rights="none" pattern="PDF" />
# を <policy domain="coder" rights="read|write" pattern="PDF" />
# に変更

メモリエラー

# メモリ使用量を制限
ffmpeg -threads 4 input.mp4 output.mp4
magick -limit memory 2GB -limit map 4GB input.jpg output.jpg

リソース

• FFmpeg: https://ffmpeg.org/documentation.html
• FFmpeg Wiki: https://trac.ffmpeg.org/
• ImageMagick: https://imagemagick.org/
• ImageMagick 使用方法: https://imagemagick.org/Usage/