Communitygithub.com

ファイナルパス — 公開前に全レンダーをQC

レンダー済み動画を出す前にチェック:フォーマット、黒コマやフリーズ、ラウドネス、トゥルーピーク、そして目視用のフレームシート。アニマティックや最終版を提出する前に使います。

ファイナルパス — 公開前に全レンダーをQC とは?

Launch Video レシピのステップ3(出荷チェック)。GTKottman/mortiflix-oss(2026-10-05公開)より。qc.mjs がサイズ、fps、尺をブリーフと照合(誤差5%以内)し、ラウドネス(Web既定 -14 LUFS)とトゥルーピーク(-1 dBTP)を確認、意図的なホールド(--end-hold、--allow-black)以外の黒コマやフリーズ区間を不合格にします。JSONレポートと約1秒1コマのコンタクトシートを出力。その後は人の目:シートを見渡し、最も忙しい3箇所をフルサイズで読み、一度通して聴きます。ラウドネス修正用の2パス ffmpeg loudnorm 手順付き。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GTKottman/mortiflix-oss/tree/HEAD/pipelines/_shared/skills/final-pass

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ファイナルパス

2つのパートがあり、両方とも必須です:スクリプトは機械でチェックできる項目を確認し、あなたは機械では確認できない項目を確認します。

1. チェックを実行する

node .claude/skills/final-pass/qc.mjs out/final.mp4 --size 1920x1080 --fps 30 --duration 60
  • --size、--fps、--durationはブリーフ(形状、長さ)から取得します。長さは5%以内の誤差で許容されます。
  • ラウドネス:--lufs -14(ウェブデフォルト)および --true-peak -1。ブリーフが他のターゲットを持つプラットフォームを指定している場合のみ変更してください。
  • --end-hold:動画が静止ホールド(定着するロゴなど)で終わることを意図している場合、その部分は合格となり、その長さが報告されます。それ以外の場所でのフリーズ部分は依然として不合格となります。
  • --allow-black:動画内で黒が意図的に使用されている場合のみ使用します(チャプター間のブラックへのディップなど)。その旨をチェックノートに記載してください。
  • これにより checks/qc-<name>.json と checks/<name>-sheet.png が書き出され、FAIL があれば exit 1 で終了します。

すべての FAIL を修正し、再度実行してください。フリーズ部分が意図的なホールドである場合は合格となり、チェックノートにはそのホールドがどれであるかを記載します。

2. 目視確認

  1. フレームシート。 checks/<name>-sheet.png(約1秒1コマ)を表示します。すべてのフレームが視覚的に意味をなしている必要があります:読み込み途中の要素がない、プレースホルダーテキストがない、誤った位置に留まっている要素がない、端で切れている要素がない。
  2. 最も忙しい瞬間の3つのフルサイズフレーム:ffmpeg -ss 12.5 -i out/final.mp4 -frames:v 1 checks/f-12.5.png。それらのすべての文字を読みます。
  3. 聴く:波形の最も音量が大きい部分と最も静かな部分を一度通して聞きます:クリック音、ポップ音、歪み、音楽に埋もれる言葉がないことを確認します。

3. 報告

結果をステップのエラーチェック(mfx checks <step>)にマッピングします:スクリプトとあなたの目視確認による frame-sheet と format、オーディオラインからの loudness。JSON とシートは checks/ に保管します。すべてのファイナルにフレームシートを2番目のアイテムとして提出します:オーナーが一目で確認できます。

ラウドネスの修正

ミックスに対して2パスの loudnorm を実行します。すでにノーマライズしたファイルに対しては決して実行しないでください:

ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1.5:LRA=11:print_format=json -f null -       # 測定値を読み取る
ffmpeg -i mix.wav -af loudnorm=I=-14:TP=-1.5:LRA=11:measured_I=..:measured_TP=..:measured_LRA=..:measured_thresh=..:offset=..:linear=true mix-14.wav

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル