kevinbadi/open-edits/fireship-style-edit

Fireship-style edit (faceless "Code Report" format)

Learned 2026-09-29 by reverse-engineering Fireship's "Meta is pivoting again… everything you missed from Connect 2026" (5:40, 1080p, 23.976 fps). Full study (transcript with word times, cut list, per-shot contact sheets, dense in-shot frame sheets, audio measurements): clone-projects/fireship-style-study/ (historical, not bundled) (frames/sheet_*.jpg, frames/zoom_*.jpg, audio/, cuts/). Learn the grammar; never copy their assets. No Fireship footage, music, logo or the name "Code Report" in our videos. Our show title is our own (default "The Kev Report").

Engine: templates/fireship_engine.py. Template + device demo: templates/render_template.py. Real event footage: scripts/fetch_footage.py (yt-dlp search → download → 1 s contact sheet → accurate cut). Real docs: wikipedia_extract() + wiki_doc() in the engine (REST API, no browser). scripts/capture_page.mjs needs Playwright: optional, never the default (Kevin 2026-10-02: no browser automation for assets). Demo of every device: ~/Downloads/Fireship Style Demo Reel.mp4 (built from clone-projects/fireship-demo/ (historical, not bundled)).

0. LITERAL VISUALS (Kevin 2026-10-02, first test edit review)

"the edit can be even more descriptive of what's being said ... in the intro it should LITERALLY be

the prime president of australia speaking."

The picture shows exactly what the sentence says, as literally as footage allows:

• A person did something → footage of THAT person doing it (the PM at the UN podium speaking,

Jensen on stage holding the chip). Find it with fetch_footage.py --search "<person> <event>". A flag, a city skyline or a logo is NOT a substitute for the person; it is at most an overlay.

• A company did something → its product/event footage or its own page, plus the logo as an overlay.
• People reacted → tweet cards (with platform mark + profile pictures, see below) or reaction memes.
• An abstract mechanism → the built-up diagram.
• A shot that is only a logo/sticker on black is the last resort, at most 1 in 8 shots.
• Write the shot list as time | exact VO words | what is literally on screen | source and reject any

row where the screen doesn't depict the words.

Tweet cards always look real (Kevin 2026-10-02: "the social icon was missing as well as the profile picture of the tweeter"). tweet_card() now draws the X mark top-right, a profile picture and the reply/repost/like/views row. Profile pictures: a real public figure → their real photo (split-animated-talking-head/scripts/fetch_figure.py → avatar="assets/figures/<slug>.png"); a made-up handle → leave avatar=None for the generated gradient-initials avatar. Never put a random real stranger's face on an invented post, and never invent words for a real person: a card with a real person's name/photo must show a post they actually made (fetch the text, keep it verbatim). Jokes go on made-up handles.

1. The numbers (measured, hit these)

2. Script formula (Code Report structure, with timings from the study)

1. Cold open, 0–65 s (~19%): first line is a deadpan absurd personal joke ("while I was finishing my

certification to become a Metaverse real estate agent…"), then the news in one run-on sentence, the "and because [company] already knows what we're all thinking…" turn, then the promise: "In today's video we'll break down X, look at how it actually works under the hood, and find out if it's the future of Y or just [callback joke]."

1. Date + title card, ~65 s: "It is September 25th, 2026, and you're watching [Show name]." Title card on that line.
2. History / context, 65–137 s: "Now, this isn't [company]'s first attempt…" with an archival year label ("2018"), a stamp ("DISCONTINUED"), a punchline.
3. How it works (the technical core), 137–198 s: one long diagram build in sync with the narration, then the catch ("But ironically…", "and that's where he's still kind of lying").
4. Rapid-fire product news, 198–277 s: specs + price stickers ("$1,300", "$449"), famous-people B-roll with dry asides, one "one more thing".
5. Sponsor, 277–332 s (~16%): segue from the last topic ("But if you'd rather not wait until December for… you can build… today with [Sponsor]"), a mini story told through the product's screen recordings.
6. Outro, 8 s: "This has been [Show name], thanks for watching, and I will see you in the next one." Title card + "link below" sticker.

Voice rules: deadpan, never hype words; a joke every ~10–15 s, usually as a hard-left turn at the end of a factual sentence ("…send flowers to your wife's boyfriend"); callbacks to the cold-open joke at the end of the intro; specific numbers and names always; pop-culture comparisons; mild irreverence, but punch at companies and the powerful, not at groups of people. Keep sentences long and rolling. The VO carries all the information; visuals carry the jokes.

3. Visual devices (engine function → when)

Composition rules seen in every frame:

• Cards sit on the near-black ground (14,14,16), centered or offset, never framed in a UI chrome.
• Overlaps are deliberate: second card overlaps the first by ~15–25%, opposite tilt.
• Stickers are big (100–220 px text) and tilted −12…+10°; they pop in with overshoot and then hold still.
• Brand marks are real (fetch with split-animated-talking-head/scripts/fetch_brand_asset.py).
• Every beat lands on the spoken word: at(WORDS, "word", after), max lead 0.1 s.

4. Pipeline

WD=clone-projects/<slug>-fireship && mkdir -p $WD/{audio,assets/{shots,logos,cutouts,gifs},frames} && cd $WD
cp "<skill>/templates/render_template.py" render.py

1. Script (section 2 formula, ~210 wpm → a 5 min video ≈ 1,050 words). Kevin records the VO, or

ElevenLabs (voice id from .env.local), saved as audio/voice.wav. Jump-cut silences > 0.3 s (ffmpeg silenceremove or the HyperFrames CLI) before transcribing.

1. Words: Whisper small.en with initial_prompt = the product/people names → audio/words.json

([[word, start, end]]). Fix mishears first; every beat keys off it.

1. Shot list: walk the transcript, one Shot per ~2 s, one device per clause. Write it as a

table (time | VO words | device | asset) before coding. Budget: ~1 meme per 15 s, 1 diagram, 3–6 doc highlights, 4–8 tweet/headline stacks, stickers everywhere.

1. Assets (before choreography, literal-first, section 0):

• Footage of the people/events named:

python3 <skill>/scripts/fetch_footage.py --search "<person> <event>" → --id <id> --slug x → --slug x --sheet --from A --to B (1 frame per second; a 5 s sheet picked the wrong moments in the first test) → --slug x --cut START DUR → video_bg("assets/footage/x_START.mp4", 0). A YouTube 403 means a stale yt-dlp: the script runs yt-dlp -U and retries. Prefer uploads < 10 min.

• Free stills: Wikimedia Commons API (generator=search&gsrnamespace=6) → image_bg().
• Docs: wikipedia_extract("Prompt injection") → wiki_doc(); other sites: fetch text with curl/APIs

and doc_card(wrap_text(...)). No Playwright unless Kevin asks.

• Logos (fetch_brand_asset.py), portraits for real tweeters (fetch_figure.py), Giphy memes, cutouts.
• Build a contact sheet of everything and LOOK before choreographing.

1. Author `render.py`: SHOTS = [Shot(t0, t1, bg=…, layers=[Layer(t0, t1, img=…, xy, tilt, anim)])]

with times from at(WORDS, …).

1. Preview: PREVIEW="1.0,5.2,…" python3 render.py → tile the frames and LOOK (dead frames,

stacked text collisions, a sticker covering the thing it points at).

1. Render + mux:

``bash N=$((DUR*30)); for i in 0 1 2 3; do RANGE="$((i*N/4)):$(((i+1)*N/4))" python3 render.py & done; wait python3 -c "from fireship_engine import mux; mux('frames/out','audio/voice.wav','assets/music_bed.mp3','renders/final.mp4')" cp renders/final.mp4 ~/Downloads/"<Readable Name>.mp4" `` Music bed: royalty-free/owned only (it runs the whole video, so it can't follow the 10 s rule below).

Clip + audio policy (Kevin 2026-10-02): any clip and any audio may be used in our edits (news and event footage, memes, a creator's audio overlay). Rule: no single third-party clip on screen for more than 10 s in a row; cut away and come back if needed. Don't add copyright caveats to deliveries. Vertical version of this format: fireship-style-short.