Communitygithub.com

freudianflips/breakout-launch-videos

ローンチフィルムのナレーション制作のためのツールマニュアル:音声キャスティング、1行ごとの収録、フレームに合わせたテンポ調整、ワードレベルのタイムスタンプ、強制アライメント、ビンテージナレーター加工、スクラッチ音声生成。

breakout-launch-videos とは?

このスキルは、製品ローンチフィルムのナレーション(音声ガイド)を制作するための包括的なツールセットです。スクリプトが承認された後、ピクチャータイミングが確定する前に使用することを想定しており、Higgsfieldの約100種類のプリセットボイスからキャスティングを行い、スクリプトの各行を個別の音声ファイルとして生成します。各音声ファイルは、フレーム内に収まるようにペース調整され、さらに強制アライメントによって各キーワードが映像の該当フレームに正確に一致するようワードレベルのタイムスタンプが付与されます。また、macOSのsayコマンドやespeak-ngを使った無料のスクラッチ音声生成機能、またはChatterbox(MITライセンス)によるローカル音声クローン機能も提供し、本番音声が利用できない場合の代替手段を確保します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、`launch-film`プロジェクト内の他のスキルと連携して動作します。特に、映像とナレーションの完全な同期が求められるプロフェッショナルなローンチフィルム制作において、手動で調整するよりもはるかに高速で正確なアライメントを実現します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-voice

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

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

ドキュメント

Launch voice

launch-film 下のツールマニュアル。skills/launch-film/SKILL.md から開始:ここにコア、フック+ボディテンプレート、および教訓が含まれます。このページが異なる場合、launch-film が優先されます。

現代のローンチフィルムでは、音声が主導し、映像は単語ごとにそれを説明します。「tagged」と音声が言うとき、何かがタグ付けされます。これは、すべての単語にタイムスタンプがある場合にのみ機能します。

プロバイダー

  • デフォルト:自身のアカウント上の Higgsfield。 text2speech_v2(エンジン elevenlabs、minimax、seed_speech など、音声により異なる)を使用し、約100のプリセット音声からキャスティングし、1行あたり約0.3クレジット。Seed Audio は、プロンプトとオーディオリファレンスで操作できるナレーターを生成。scripts/hf_voice.py がCLIをラップします。
  • 無料スクラッチ音声: scripts/scratch_voice.py は、macOS の say(またはLinux の espeak-ng)で仮のテイクを作成します。これでフィルム全体を構築しタイミングを調整し、すべてのレビューに「スクラッチ音声」とラベル付けし、後で本番テイクに置き換えます。
  • 無料ローカルクローン: scripts/clone_local.py(Chatterbox、MIT)は、承認されたナレーターの音声を、そのセリフの8~10秒からクローンします。代役であり、マスターではありません。権利のある音声のみをクローンしてください。
  • 音声は、単独のクリップではなく、完成したフィルム内でレビューします。却下された音声のリストを保持し、再度提案されないようにします。

キャスティング

  1. python3 skills/launch-voice/scripts/hf_voice.py cast "<the film's opening line>" film/vo/audition は、すべてのプリセット音声(約110の音声で約34クレジット)で最初の行を読み上げ、各テイクを Whisper でチェックし、ペースとピッチの動きを測定します。ranking.md には、正確なテイクが最初にリストされ、次に約2.5語/秒、約2半音の動き(会話調、アナウンスではない)に近いものが続きます。--only Name,Name で少数を再キャストできます。
  2. 性別を問わず上位6程度を選び、完全なスクリプトでテストします(hf_voice.py lines)、次にそれらをフィットさせます(下記参照)。12%以上のスピードアップが必要な音声はスクリプトに対して遅すぎます。その音声をドロップするか、単語を削ってください。
  3. 生き残った各音声でフィルム全体を構築し、オーナーに選択させます。テストでは、ElevenLabs のペースとピッチのばらつきが最も少なかったため、デフォルトのエンジンです。

長さとペース

  • 目標は、1秒あたり2.2~2.7語。優れたリファレンスローンチでは2.4語でした(63秒で151語)。
  • 20秒のフィルムは約45語、30秒は約70語、60秒は約140語を想定。音声をスピードアップする前に、単語を削ってください。
  • ストーリーボードのフレームごとに1行、6~20語で、キーとなる名詞や動詞がビートに合うようにフレージングします。

フィルムテンプレートの手順

  1. スクリプトは film/film.json の lines にあります。1行につき1ファイルを film/vo/body/line-<id>.wav に記録します。本番テイクは hf_voice.py lines(lines を {"lines": [{"line": "02", "text": "..."}]} として記述)、スクラッチテイクは python3 skills/launch-voice/scripts/scratch_voice.py film/film.json(--hook film/hooks/<name> を追加してフック行も音声化)を使用します。
  2. python3 skills/launch-voice/scripts/prep_lines.py film/film.json を実行します(--align force で強制アライメントを強制;uv がインストールされている場合、初回実行時に torch を取得、約2GB)。これにより、各行の継続時間と単語時間を含む film/vo/body/lines.json が書き出されます。torch が利用可能な場合は強制アライメント、そうでない場合は whisper.cpp、それもない場合は推定(フラグ付き)を使用します。
  3. film/build.py は、フィルムタイムライン上に行を配置し、すべてのピクチャーキューはその単語に従います。新しいテイクは、1回のプリパスとリビルドで完了します。

フリーフォームフィルムの手順

  1. vo/script-lines.json({"lines": [{"line": "01", "text": "..."}]})、次に行ごとに1ファイル:hf_voice.py lines vo/script-lines.json vo/takes/<voice> --voice <Name>。テキスト、音声、エンジン、ジョブID が lines.json に保存されます。
  2. フィット:python3 skills/launch-voice/scripts/fit_lines.py vo/placement.plan.json vo/takes/<voice> vo/versions/<voice>。計画は、各行に最も早い開始時間、息継ぎの間隔、そしてフレームが終了しなければならない場合は end_by を与えます。行内の0.25秒を超えるポーズは0.22秒に短縮されます。それでもオーバーフローする行の連続は、まとめてスピードアップされ、上限は12%です。次にスティッチ:python3 skills/launch-voice/scripts/stitch.py vo/versions/<voice>/placement.json vo/versions/<voice> vo/versions/<voice>/vo.wav。
  3. 行ごとの単語時間。ビジュアルを合わせる必要があるものには、強制アライメントを使用します:uv run -q --with torch --with torchaudio --with soundfile python skills/launch-voice/scripts/force_align.py line.wav "the exact words"。クイックリードには、align_lines.py が whisper.cpp を行ごとに実行します。アンカーは発話順に解決されるため(各アンカーは前のアンカーの後の最初の一致)、どの音声でもフィルムのタイミングが再調整されます。フィルム全体に対して1回の whisper パスでは行の終わり付近でずれが生じますが、行ごとのパスではずれません。
  4. 単語時間を launch-motion(各ビルドをその単語にアンカー)と launch-sound(イベントは単語に従う)に渡します。

ビンテージナレーター

アーカイブ風やドキュメンタリー風のオープニングの場合:python3 skills/launch-voice/scripts/vintage.py IN.wav OUT.wav --crackle crackle.wav は、帯域を150 Hz~5.8 kHzに制限し、テープサチュレーション、スローなワウ、実際のビニールのパチパチ音(Seed Audio で1つ生成)を追加します。Seed Audio は、ビンテージナレーターの声で直接行を話すこともできます("a warm, deep 1960s documentary narrator on an old vinyl record ... exactly these words: ...")。ゆっくりと読み、言い回しを変える可能性があるため("gotta" が "got to" になるなど)、Whisper で確認してください。

同期ルール

  • キーワードは、そのビジュアルと2フレーム以内に一致するようにします。キーワードの最初のフレームでビルドを開始します。ビジュアルをその単語より先行させる場合は、4フレーム未満に抑え、すべての場所で統一します。
  • シーンの切り替わりでは、行間に0.25~0.5秒の息継ぎの間隔を設けます。
  • 最後の行は、ロゴの少なくとも1秒前に終了します。ロゴには独自のほぼ無音の領域が与えられます(launch-mix ドロップアウト)。

音声プロバイダーが利用できない場合

スクラッチ音声でビルドし、すべてのレビューにスクラッチとラベル付けし、ピクチャーを調整された単語にアンカーしたままにします。これにより、本番音声への差し替えは1回のプリパスとレンダリングで完了します。オーナーの許可なしに、音声プロバイダーやアカウントを切り替えないでください。

修正

  • 行が5%未満オーバーランする場合:ffmpeg -af atempo=1.04。それ以上の場合:行を書き直します。
  • 単語の発音が間違っている場合:スクリプトではなく、行の say フィールド(hf_voice.py 用)で音声的に綴り直します。
  • Whisper がソフトな語尾を聞き間違える場合:強制アライメントを使用するか、アンカープレフィックスを短くします。再録音はしないでください。
  • 数字:アライメントするテキストではスペルアウトします("24" ではなく "twenty four")。
  • Whisper ベースモデルは製品名を聞き間違えます。最終的な単語は、スモールモデルかそれ以上(WHISPER_MODEL)で確認してください。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

freudianflips/breakout-launch-videos

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (measuring a render and studying a reference film). Review a rendered launch film like a demanding creative director, then drive the v1 to v2 loop. Measures rhythm, static runs, cuts against the beat grid, loudness, true peak and voice pace with a script, then applies an eye checklist for continuity at every cut, legibility, brand, real UI, claims and differentiation. Writes a gap list and a scorecard; nothing ships on numbers alone. Use on every render, and on a reference film to learn from it, for "review the video", "check the film", "what is wrong with this cut", "study this reference".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (backgrounds, plates, Blender glass and 3D shots, shader layers). Build the world a launch film lives in, in your own brand, with generated background plates (cost-gated), Blender for real 3D glass objects and camera moves rendered as alpha layers, WebGL shader layers for atmosphere, and the layer order, depth of field and grade that keep UI legible over living backgrounds. Use when a storyboard needs backgrounds, 3D or atmosphere, for "background", "plate", "3D object", "glass", "Blender", "shader", "atmosphere"; motion of the UI itself is launch-motion.

関連スキル