media-transcoding

メディアのトランスコード（FFmpeg）

概要

FFmpeg のプリセットを使用して、Web ストリーミング、モバイル配信、またはアーカイブ品質向けに動画出力を標準化します。hf-videos リポジトリには、シンプルな Bash スクリプトと、プリセット、バックアップ、ログ機能を備えた、より高度な Python スクリプトがすでに含まれています。

クイックスタート（hf-videos）

./ffmpeg_convert.sh check
./ffmpeg_convert.sh web_standard "My Video.mp4"
./ffmpeg_convert.sh batch_web_standard

出力は converted/ に書き込まれ、バックアップは backup/ に、ログは conversion.log に保存されます。

プリセットの概要（hf-videos）

• web_standard：最大 1080p、CRF 23、128k オーディオ、+faststart
• web_high：最大 1080p、CRF 20、192k オーディオ
• mobile：最大 720p、CRF 25、96k オーディオ
• ultra_compact：最大 480p、CRF 28、64k オーディオ
• archive：元の解像度、CRF 18、256k オーディオ

すべてのプリセットでは、ストリーミングに適した MP4 にするため、H.264 と AAC に +faststart を使用します。

バッチワークフロー

1. まず単一ファイルの変換を実行して、出力を検証します。
2. プリセットを確認したら、バッチ変換を実行します。
3. 出力サイズと再生を確認します。

バッチコマンド：

./ffmpeg_convert.sh batch_web_standard
./ffmpeg_convert.sh batch_mobile
./ffmpeg_convert.sh batch_ultra_compact

高度なスクリプト（convert_video.py）

次の機能が必要な場合は、convert_video.py を使用します。

• 進行状況のモニタリング
• メタデータの検査
• 上書きの制御
• プリセットの一覧表示とバッチ自動化

python3 convert_video.py --list-presets
python3 convert_video.py --file "My Video.mp4" --preset web_standard
python3 convert_video.py --preset mobile --overwrite

出力規則

• 変換されたファイルには、_web_standard のようなサフィックスが付きます。
• バックアップでは元のファイル名が保持されます。
• 監査とトラブルシューティングのため、ログは conversion.log に保存されます。

トラブルシューティング

• FFmpeg が見つからない：brew install ffmpeg（macOS）を実行するか、ffmpeg.org からインストールしてください。
• 権限エラー：chmod +x ffmpeg_convert.sh を実行してください。
• ディスク容量の圧迫：検証後に converted/ と backup/ をクリーンアップしてください。

関連スキル

• toolchains/universal/infrastructure/docker