Diffie hummingbird Production notes
August 17, 2026 verified artifact

A transparent build log

Four lines in.
A social video out.

This is the full production record for turning a private Diffie browser-test replay into a polished 27.5-second product video: the brief, extraction path, programs, rejected draft, benchmark, frame renderer, audio, privacy controls, and final QA.

27.5sruntime
1080×1920vertical
30 fps825 frames
−16.4 LUFSaudio
FINAL CUT · H.264 + AAC00:27.50
01 — Inputs

What I was actually given

There were three creative inputs and one private product artifact. Separating them matters: the social “four lines” are an editorial condensation, not a claim that the original test specification contained only four literal lines.

Private artifact

A tokenized Diffie preview URL

The preview exposed a real test result and an rrweb replay. The URL, token, host, credentials, signer identities, and connection details were treated as secrets and are not reproduced here.

Message direction

Start with the post-deploy problem

Lead with: “When was the last time you clicked through your product to see if a deployment broke something?” Then show the short plain-English input and the resulting browser proof.

Format request

Use the replay. Cut the video.

Do not write a caption around a static screenshot. Find practical hook and editing guidance, use the recording itself, and produce a native social asset for LinkedIn and X.

Condensed creative brief“When did you last click through your product after a deploy to make sure nothing broke? Tell Diffie what needs to work—in four lines. Show the real browser run. End on the verified outcome.”
Public-safe wording: the generated test ran one sequential two-signer workflow and that individual run passed. The video does not claim a universal pass rate, broad reliability statistic, or behavior that the artifact did not demonstrate.
02 — Source truth

First understand the run

Before editing, I inspected the test status, generation status, replay, and outcome. The story had to come from the demonstrated workflow—not from generic “AI testing” language.

PreviewOpen securely
ReplayCapture proof
EditBuild story
AuditPublish safely
Observed workflow

Two signers, sequential order

The run prepared a document, launched a two-recipient signing journey, completed signer one before signer two, and reached the final document state.

Observed outcome

Final artifact checked

The useful story was not “a bot clicked buttons.” It was that the test followed the handoff and checked the finished document with both signatures.

API state

Processed → generated → passed

The test was processed, generation completed, and the individual run passed. Those statuses anchored every outcome claim in the video.

03 — Iteration

The first answer was not good enough

The initial cut was technically correct and publication-safe, but it looked like a screen recording placed inside a dark template. The criticism was right: it needed a coherent editorial system, tighter crops, purposeful motion, voice, and sound.

Earlier dark 4 by 5 draft with a large product recording and static text blocks
Earlier draft: clear message, but visually dense, static, and too dependent on unreadably small product UI.
1

A recording is evidence, not the whole composition

The UI should be cropped to the action that matters instead of being shown as a tiny full-screen rectangle.

2

The hook must be a scene

Large typographic beats and a highlighted phrase create an opening that reads in a feed before the viewer turns sound on.

3

Brand is a system

The final direction uses warm cream, Diffie yellow, deep plum, a grid, print-like texture, the hummingbird, rounded browser cards, and repeated status labels.

4

Audio changes perceived quality

Voiceover carries the explanation; music, clicks, wipes, and success cues make the visual transitions feel intentional.

Benchmark used: a short CMDK/Gmail product tutorial was analyzed for its economy: one problem, one action at a time, high-contrast captions, focused screen crops, and a clean end card. The visual language was not copied; the pacing principles were translated into Diffie’s own brand system.
04 — Workflow

Step by step, from preview to MP4

This is the reproducible path. The sensitive identifiers are deliberately omitted, but the programs and transformations are concrete.

Research social hooks and editing patterns

I loaded social-platform, hook-writing, LinkedIn, FFmpeg, video-editing, and Remotion guidance. The useful rules were: lead with the viewer’s problem, keep the hook above “see more,” preserve real product proof, re-encode frame-accurate cuts, and make every overlay earn its place.

Remotion was considered, but a custom Pillow/NumPy renderer plus FFmpeg was faster and more deterministic in the available environment.

Open the preview and locate the replay artifact

A browser/CDP harness opened the supplied preview. I inspected the page and API responses, found the rrweb recording, and isolated the replay from surrounding admin UI. Nothing from the tokenized URL was put into the output.

Discovery outline — credentials intentionally absent
open_preview(TOKENIZED_URL)
status = read_test_status()        # processed
generation = read_generation_status() # completed
run = read_run_status()            # passed
recording = download_rrweb_artifact()

Capture the replay as editable video

The isolated rrweb player was recorded at 1920×1080, 30 fps. The resulting replay-raw.mp4 was 23.37 seconds, H.264, and silent. This gave FFmpeg and the Python renderer a conventional media source rather than a browser event log.

Source probe
ffprobe -v error \
  -show_entries stream=codec_name,width,height,r_frame_rate \
  -show_entries format=duration,size \
  -of json replay-raw.mp4
# 1920×1080 · 30/1 fps · 23.366667 s · H.264

Set a privacy boundary before creative work

I made an explicit denylist: preview token, test UUIDs, source host/IP, credentials, signer emails, signing links, raw generated code, connection details, and any traceable source identifier. The social edit uses blurred or tightly cropped product proof and replaces sensitive detail with safe editorial labels.

Translate the run into four editorial lines

The final prompt card is a compact narrative device:

  • Log in and open the template
  • Create a two-signer request
  • Complete both signatures
  • Verify the final document

These lines summarize the demonstrated run for a social viewer. They are not presented as a verbatim export of the private test specification.

Create a clean product plate

The raw 16:9 replay was trimmed to the useful 20.73-second window and converted into a clean 1016×572 product plate. That plate was decoded to 622 JPEG frames so the renderer could choose, crop, scale, and animate exact moments.

Frame preparation
ffmpeg -i clean-demo.mp4 \
  -q:v 2 demo-frames/frame-%05d.jpg
# 622 frames available to the compositor

Write the visual compositor in Python

render_premium_v2.py is the main program: 509 lines of Pillow/NumPy composition. It creates texture, typography, brand header, prompt card, browser chrome, progress labels, focused camera crops, yellow wipes, success graphics, and the end card.

render_premium_v2.py — scene router
def render_frame(t):
    if t < 3.30:  frame = opening_scene(t)
    elif t < 3.82: frame = wipe_transition(...)
    elif t < 7.25: frame = prompt_scene(t)
    elif t < 7.82: frame = wipe_transition(...)
    elif t < 23.35: frame = demo_scene(t)
    elif t < 24.05: frame = wipe_transition(...)
    else: frame = end_scene(t)

Render small, then upscale cleanly

Each of the 825 frames was composed at 720×1280 for speed, piped directly to FFmpeg, and upscaled with Lanczos to 1080×1920. H.264 High profile, yuv420p, and +faststart keep the file compatible and web-friendly.

render_premium_v2.py — encoding process
ffmpeg -f rawvideo -pix_fmt rgb24 -s 720x1280 -r 30 -i - \
  -vf scale=1080:1920:flags=lanczos \
  -c:v libx264 -preset medium -crf 17 -pix_fmt yuv420p \
  -movflags +faststart premium-v2-silent.mp4

Add voice, music, and interaction cues

The narration was generated through the configured Hermes text-to-speech tool. generate_sound_bed.py synthesized an original 48 kHz stereo music/SFX bed with NumPy: harmonic pulses, a restrained bass pattern, UI clicks, transition sweeps, and a success chord. FFmpeg mixed the tracks and normalized the result.

Voiceover script
After every deployment, someone still has to click through the product
and hope nothing broke. With Diffie, describe the workflow in four lines
of plain English. Diffie turns it into a real browser test, runs the journey
end-to-end, and checks the actual outcome. Here, both signers complete the
document, and the final state passes. Four lines in, a real test out.

Audit the export instead of trusting the render

The final file was fully decoded to catch corrupt frames, probed for codecs and dimensions, measured with EBU R128, sampled into contact sheets, checked at transition boundaries, and scanned across 55 frames for exact matches to sensitive source identifiers.

Mechanical validation
ffmpeg -v error -i diffie-premium-social-v2.mp4 -f null -
ffprobe -v error -show_streams -show_format -of json \
  diffie-premium-social-v2.mp4
ffmpeg -i diffie-premium-social-v2.mp4 \
  -filter_complex ebur128=peak=true -f null -
# Full decode: PASS · Integrated loudness: −16.4 LUFS
05 — Story structure

One job per scene

The composition moves from problem → short input → browser evidence → verified outcome. The UI never has to carry the narrative alone.

Eight-frame storyboard of the final Diffie social video showing the deployment problem, four-line brief, browser execution, signer sequence, final verification, and end card
Eight sampled beats from the final vertical edit. Product details are intentionally blurred or framed to avoid exposing private data.
Problem hook0:00–0:03.30
Four-line brief0:03.82–0:07.25
Real browser proof0:07.82–0:23.35
Outcome / CTA0:24.05–0:27.50
06 — Toolchain

Programs and tools used

No single “make product video” button produced this. Each tool had a narrow job, and the final quality came from the handoffs between them.

Browser/CDP harness

Opened the private preview, inspected the replay, isolated the player, and captured product evidence.

rrweb replay

Reconstructed the browser journey from the recording artifact before conventional video capture.

FFmpeg + FFprobe

Trim, crop, decode, extract frames, encode H.264, mix AAC, measure loudness, and validate metadata.

Py
Python 3.11

Orchestrated the compositor, security scans, asset preparation, and deterministic rendering.

Pillow

Drew every frame: typography, cards, texture, masks, crops, status chips, wipes, and end card.

NumPy

Generated the music/SFX bed sample by sample and supported image compositing math.

Aa
Hermes TTS

Rendered the narration through the configured text-to-speech provider.

OCR + visual QA

Sampled 55 frames, searched for source identifiers, checked transitions, and reviewed contact sheets.

07 — Tweak map

What to change—and where

The output is code-driven. Feedback can be specific: change the hook, shorten the prompt card, adjust a crop, lower the music, or shift the brand palette without rebuilding the whole workflow.

Change the headline or four-line brief

Edit the text inside opening_scene() and prompt_scene().

premium-v2/render_premium_v2.py · approximately lines 291–325

Also update the voiceover so spoken and visual claims remain aligned.

Change scene timing

Edit the thresholds in render_frame(t): 3.30, 3.82, 7.25, 7.82, 23.35, and 24.05 seconds.

premium-v2/render_premium_v2.py · approximately lines 453–466
Change camera crops or demo pacing

Edit demo_phase() and the camera_crop() targets. Each phase maps the clean replay to a focused UI moment.

premium-v2/render_premium_v2.py · approximately lines 329–451
Change the visual brand system

The top-level constants control cream, ink, yellow, green, purple, canvas size, fps, and font paths.

premium-v2/render_premium_v2.py · approximately lines 18–35
Change music or sound effects

Edit the event list for clicks, transitions, success cues, and the harmonic/bass patterns. Keep the final mix around social-video loudness rather than maximizing peak volume.

premium-v2/generate_sound_bed.py · approximately lines 49–90
Change output quality or platform shape

Edit W/H, the final scale, CRF, and pixel format. Recheck text safe areas if moving from 9:16 to 4:5 or 1:1.

premium-v2/render_premium_v2.py · approximately lines 22–23 and 487–498
Best feedback format: “At 8.2–11.0 seconds, zoom 15% farther into the recipients panel and shorten the caption to ‘Two signers, in order.’” That maps cleanly to one phase, one crop, and one string.
08 — Verification

What “done” meant

A render existing on disk was not enough. The deliverable had to decode, fit social-video conventions, sound controlled, preserve the actual test story, and avoid exposing private data.

PASSFull 27.5-second decode completed with no media errors
1080×1920H.264 High, yuv420p, 30 fps, web fast-start
AAC 48 kHzStereo audio, approximately −16.4 integrated LUFS
55 framesSampled and scanned; no exact source-identifier matches
Visual review

Transitions and status graphics

Opening, wipes, browser crops, sequential-signer callouts, final verification graphic, and end card were reviewed at full resolution.

Claim review

One demonstrated run

Copy was constrained to what the preview proved: this generated two-signer run completed and passed.

Security review

Secrets stay private

The public output contains no preview URL, token, source host, credentials, signer email, raw test code, or connection details.

09 — File map

The artifacts behind the result

This is the relevant project structure. Sensitive source files remain local and are not linked from this page.

diffie-four-lines-demo/
├── replay-raw.mp4                    # private raw replay; do not publish
├── recording-….json                 # private rrweb artifact; do not publish
├── render-social-video.sh            # superseded 4:5 experiment
├── social-copy.md                    # LinkedIn and X drafts
├── research-skills/                  # hook/editing references
└── premium-v2/
    ├── render_premium_v2.py         # main 509-line frame compositor
    ├── generate_sound_bed.py        # original 48 kHz music + SFX
    ├── clean-demo.mp4                # sanitized product plate
    ├── demo-frames/                  # 622 decoded source frames
    ├── premium-v2-silent.mp4         # 825-frame visual render
    ├── storyboard-contact.jpg        # review sheet
    ├── final-ocr/                    # 55-frame security sample
    ├── final-audio-audit.log         # EBU R128 measurement
    └── diffie-premium-social-v2.mp4 # final deliverable

The workflow is now a reusable Diffie skill.

diffie-social-video captures the source-discovery sequence, claims discipline, privacy denylist, hook framework, 9:16 render architecture, audio targets, QA gates, deliverable format, and common failure modes from this project.

Download SKILL.md ↓