動画エディター — 1%テンプレート
Pythonパイプライン(編集ソフト不要):生の動画 + config.json → 最高品質の最終動画 + _PORTADA.png。
スクリプトはこのスキルの scripts/ にあります。出力と work/ フォルダは コマンドを実行したディレクトリ に作成されます(プロジェクトごとにフォルダを使用してください)。
0. 開始前(一度だけ)
- このスキルの
MARCA.mdを読む:アクセントカラー、ブランド名、ハンドル、フレーズ。未入力の場合はユーザーにこれらの情報を尋ね、記入してください。 - 依存関係:
pip install -r scripts/requirements.txt(numpy, pillow, imageio-ffmpeg, faster-whisper)。初回の文字起こしでWhisperモデル「medium」(約1.5GB)をダウンロードします。
ショートカット:以下のコマンドで、S = このスキルの scripts/ へのパス(例:~/.claude/skills/editor-videos-1porciento/scripts)。
1. 動画ごとのフロー
- 設定:
ejemplos/historia_ejemplo.json(9:16)またはejemplos/feed_ejemplo.json(4:5)をプロジェクトフォルダにコピーし、video、words、salida、marca、acento、cierre、portadaを入力します。recorte:元の動画から使用する領域(x, y, w, h、ピクセル単位)。フォーマットのアスペクト比(9:16 履歴、4:5 フィード)に一致している必要があります。元のサイズはffprobeで事前に測定してください。
- 文字起こし:
python S/editar_video.py transcribir config.json→ 単語ごとの時間情報を持つwords.jsonを生成します。 - 手動で words.json を修正:固有名詞、ブランド名、数字(「1%」)、慣用句。
*_words_ok.jsonとして保存し、config でそのファイルを指定します。config の"vocabulario"に頻出する固有名詞を追加すると、Whisper の精度が向上します。 - 無音カット:
python S/auto_cortes.py video.mov 0.12→cortesのリスト(音声エネルギーに基づいて計測。Whisper のタイムスタンプは使用しません)を出力します。それを"cortes"に貼り付けます。カットが同じ単語の途中に落ちた場合は削除してください。 - キーワード(
claves):字幕内でアクセントカラーで表示される単語。words.json に記述されている通り(句読点も含む、例:"tiempo.")に正確に記述します。 - モーショングラフィックス(
motion):デフォルトで常に使用し、1動画あたり3~6個、スクリプトの重要な箇所に配置します。以下の表を参照。 - ズーム(
zoom)と音楽(musica):デフォルトで有効。 - レンダリング前にフレーム確認:
python S/editar_video.py preview config.json 4.5→work/_prev_4.5.jpg(最終動画の秒数)。字幕、モーショングラフィックス、顔のフレーミングを確認します。 - レンダリング:
python S/editar_video.py render config.json→salida.mp4+salida_PORTADA.png。 - 結果のフレームを確認(ffmpeg select で3~4フレームを一連で表示)してから納品します。完了したら、動画が保存されたフォルダをユーザーに開いて見せます。
ユーザーが「履歴(ストーリーズ)」と「フィード」の両方を希望する場合は、2つの設定ファイルを作成します(同じ words.json、異なる formato/recorte/subs_y/位置)。8GBのRAMで2つを並行レンダリングできます。
2. 学んだルール(必ず守ること)
- VADなしで文字起こし(スクリプトは既にそうなっています):VADを使用すると最初のフレーズが失われます。
- iPhone HDR動画(HLG、4K60):zscale でトーンマップを適用しないでください(アーティファクトが発生します)。スクリプト内のソフトなeqを適用した生データで十分に綺麗に表示されます。
- 常に最高品質:H.264 crf 14 preset slow、AAC 320kbps、音声は -14 LUFS にノーマライズ。サイズを軽くするために品質を落とさないでください(依頼があった場合を除く)。
- 字幕の位置:
subs_yは履歴で約1300(IGのセーフゾーン)、フィードで約1060。モーショングラフィックスは上部に配置し、顔や字幕から離してください。 - 画面上のテキスト:短く、大文字で、直接的。長いフレーズは使用しないでください。
3. Config リファレンス
| キー | 説明 |
|---|---|
formato | "historia"(1080x1920)または未設定 = フィード(1080x1350) |
video, words, salida | 生動画、words.json、最終mp4へのパス |
recorte | 元動画の {x,y,w,h} |
pre / post | 最初の単語の前/最後の単語の後の余白(秒) |
subs_y | 字幕のY位置 |
claves | アクセントカラーで表示する単語 |
cortes | 削除する元動画の時間範囲 [[ini, fin], ...](秒) |
acento | ブランドカラー [R,G,B](デフォルト:コーラル [255,104,74]) |
marca | ブランド名(オープニング/クロージングプレートとサムネイルに表示) |
logo | ロゴの正方形PNGへのパス(サムネイル、オプション) |
logo_led | ロゴが光るネオンサインの写真 → 「LED」オープニング/クロージング。未設定の場合はカラープレートを使用 |
placa | カスタムオープニング/クロージング:{"marca","color","kicker","filas":[...],"pie","size","entrada","cierre"} |
sin_intro | true = 動画から直接開始 |
cierre | {"titulo":[...],"by","fecha","plataformas","handle"}(LEDクロージング) — プレート使用時は by、fecha、handle を使用 |
cierre_seg | クロージングの長さ |
portada | {"segundo","kicker","titulo":[行],"size","fecha","pie"} |
zoom | `{"push":0.05,"cortes":0.08,"cara":[x,y],"punch":[{"palabra","hasta" |
musica | {"bpm":92,"seed":3,"vol":0.2,"ducking":0.75} — 生成されたビート(著作権フリー)、音声があるときだけ自動で音量低下。seed を変更すると別のバリエーション |
vocabulario | Whisperを補助するための固有名詞テキスト |
モーショングラフィックス(motion:イベントのリスト)
各イベント:{"tipo", "palabra", "hasta" または "dur", "extra", "txt", "pos":[x,y], "size", "rot", "anim", "escala", "offset"}。pos = 最終フレーム内での要素の中心。
palabra が発声されたときに表示され(繰り返される場合は "n": 2 = 2回目)、hasta(+extra 秒)または dur 秒後に消えます。anim:"pop"(デフォルト)、"slide"("desde" ピクセル指定)、"slam"。
| タイプ | 説明 | 固有フィールド |
|---|---|---|
texto | アウトライン付きの大きなテキスト | txt, size, coral:true = アクセントカラー |
chip | 角丸ラベル | txt, size, claro |
sello | 傾いたスタンプ | txt, size, rot |
slam | 打ち込む巨大な数字/単語 | txt, size |
calendario | カレンダーの紙 | txt(曜日)、big(数字)、sub |
envivo | 「EN VIVO」バッジ | txt |
plataforma | ソーシャルメディアバッジ(色付き)(TIKTOK、YOUTUBE、KICK;その他のテキスト = ダークバッジ) | txt |
contador | カウントする数字 | motion.py 参照 |
misterio | ゲストカード(疑問符付き) | lineas |
各モーショングラフィックスには自動で効果音が付きます。
4. Showreel(音楽のリズムに合わせた音声なしクリップ)
python S/showreel.py config.json — clips(各クリップは beats の長さで、label を持つことができます)、bpm、formato、etiqueta_y、textos、placa、seed、vol を含む設定。作成前に showreel.py の main() を読んで、各クリップの正確なフィールドを確認してください。
5. 他のツールを使用するタイミング
- より複雑なアニメーション/モーションデザイン(アニメーションタイトル、説明動画、3Dイントロ、グラフィックス):スキル
hyperframes(HyperFrames 公式ルーター) - YouTube向けの長尺編集、エラー/繰り返しのカット、ストーリーテリング:Nate Herk キットのスキル(
edit-video、cut-mistakes、short-form-edit、video-storytelling)、キットフォルダから実行。