Communitygithub.com

freudianflips/breakout-launch-videos

工具說明書——用於 launch-film 的匯流排混音、閃避、響度與磚牆限制器。為發佈影片的音樂、音效與旁白分別掛在獨立匯流排上進行混音與母帶,使背景音樂根據旁白即時包絡作閃避,並對中頻進行預留挖空;在 Logo 處將音樂淡出,加入黏合壓縮、真峰值安全限制器,達到 -14 LUFS 與 -1 dBTP,最後與渲染好的畫面封裝。請在配樂、音效與旁白都準備好之後,使用「mix」「master」「loudness」「LUFS」「ducking」「mux the audio」等指令。

breakout-launch-videos 是什麼?

這項技能專為 AI 助手設計,用於自動化處理發佈影片(launch film)的音訊混音與母帶。它提供一套完整的腳本工具(位於 skills/launch-film 目錄),能將音樂、音效與旁白分別放在獨立匯流排上,進行精確的閃避(ducking)、中頻預留挖空(presence carve)、黏合壓縮(glue compression)與真峰值限制(true-peak-safe brickwall limiting),最後將最終混音與 HyperFrames 渲染出的無聲畫面封裝成 MP4。此技能支援 Python 3,依賴 numpy、soundfile、pedalboard 與 pyloudnorm 等套件。使用方式很直接:先撰寫 mix.json 設定檔,再執行 mixdown.py 腳本。系統會自動檢查整合響度是否達到 -14 LUFS(±0.5 LU)、真峰值是否在 -1 dBFS 以下,並在完成後呼叫 launch-review 進行驗收。對於需要為 YouTube、LinkedIn 或 X 等平台產出專業音訊品質的開發者與內容創作者來說,這項技能能確保每次發佈的音訊既動態充足又符合串流規範,是極為實用的工具。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-mix

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Launch mix

工具手冊,位於 launch-film 下方。請從 skills/launch-film/SKILL.md 開始閱讀:該檔案包含核心、鉤子加主體範本與注意事項。若本頁與該處不一致,以 launch-film 為準。

混音是一組關係,而非一串效果器的堆疊。旁白掌握清晰度,音效掌握瞬間張力,音樂掌握節奏感並懂得適時退讓。HyperFrames 負責渲染畫面,但它沒有主匯流排,因此最終混音是在合成器外部獨立完成,再疊回已渲染的影片上。

在影片範本中,film/audio.py 會為你寫好混音檔案並執行本腳本。請使用本頁來理解與調整這些動作。

輸入

  • 音樂分軌 (launch-score)
  • sfx.wav (launch-sound)
  • vo.wav 與口白時間點 (launch-voice),若有旁白時適用
  • 畫面:HyperFrames 渲染的無聲影片

步驟

  1. 撰寫 mix.json。完整格式請參考 skills/launch-mix/scripts/mixdown.py 的標頭。
  2. 在虛擬環境(需安裝 numpy、soundfile、pedalboard、pyloudnorm)中執行 python3 skills/launch-mix/scripts/mixdown.py mix.json。
  3. 讀取輸出中的 ebur128 摘要。整合響度必須在 -14 ± 0.5 LUFS,真峰值必須在 -1.0 dBFS 或以下。
  4. 若設定 video,腳本會將主混音封裝到畫面上(video_out)。將該檔案交給 launch-review。

動作與原因

動作設定原因
旁白匯流排高通濾波 80 Hz,3:1 壓縮在 -20 dB,+1 dB 增益於 3.2 kHz穩定音量,突出子音
閃避音樂根據旁白包絡下降 8 到 10 dB,起音 80 ms,釋放 350 ms背景隨著語音呼吸,而非固定低音量
中頻預留挖空背景音在 2.5 kHz 處降低 -4 dB,並由同一包絡混合只在旁白說話時為其讓出頻率空間
音樂音色高通濾波 28 Hz,溫和的高頻與低頻斜率去除低頻隆隆聲,讓背景柔和地位於產品之後
音效匯流排高通濾波 40 Hz,2.5:1 壓縮在 -18 dB,快起音將音效整合為一個家族,讓事件感覺連貫
淡出在 Logo 出現前約 0.1 秒將音樂轉為靜音,80 ms 漸變Logo 與其音效在近乎安靜中出現,如同強大的發佈影片所作
主匯流排1.8:1 黏合壓縮,然後最多 3 次增益調整達標,以及一個前瞻磚牆限制器在上限確保音量足夠用於 YouTube,又不產生泵吸效應

無旁白時的初始音量平衡:音樂 -2 到 -4 dB,音效 0 dB。有旁白時:旁白 0 dB,音樂在閃避前 -6 dB,音效 -3 dB。

目標

  • YouTube、LinkedIn、X:整合響度 -14 LUFS,真峰值 -1 dBTP。響度範圍 1.5 到 6 LU(一個優秀的參考影片測得 1.6)。
  • 保留一份 WAV 母帶(48 kHz,24 位元)與封裝後的 MP4(AAC 256 kbps)並存。

規則

  • 不要使用 pedalboard 的 Limiter 作為上限:它行為類似於最大化器(輸出音量幾乎不隨輸入變化;一段 33 秒的測試輸出為 -10.8 LUFS)。mixdown.py 為此使用自帶的前瞻磚牆限制器。
  • 絕不要為了解決旁白音量不足而調高整個混音。應調整旁白匯流排或加深閃避。
  • 在主匯流排上,限制值永遠不要超過 3 dB;若必須這麼做,代表音量平衡有誤。
  • Logo 必須落在近乎安靜中:使用淡出或淡入,絕不能保留完整背景音。
  • 混音尚未完成,直到 launch-review 已測量過,且有人在筆電喇叭與耳機上聽過為止。

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 (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 (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

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.

相關技能