render-logo-equation-card

A card-led format: everything the viewer reads is on a static black card in the top third; under it, b-roll moves like a timelapse to stop the scroll. One animated event: the CTA line hard-cuts in at 2.0s. No voice, no captions, no cuts.

Run

python render_card.py card.json --out-dir work/            # card-no-cta.png, card-with-cta.png
python compose.py --broll broll.mp4 --cards work/ --out ad.mp4 --in 3 --speed 4 [--bed bed.mp3]
python measure_motion.py ad.mp4 --cta-at 2.0              # exit 1 = reject

card.json:

{"logos": ["partner-icon.png", "brand-icon.png"],
 "partner": {"name": "Slack", "integration_confirmed": true},
 "headline": ["= your standup, written", "before anyone opens Slack"],
 "steps": ["1. Connect your Slack workspace", "2. ...", "3. ...", "4. ..."],
 "cta": "Try it free at example.com"}

The Slack standup card above is an illustration of the schema, not a default: the headline, the partner and the steps come from the user's brand and choices.

Choices

The recipe asks these before any paid step; this renderer only draws what card.json and the flags say. The demo's value is an example, never a default:

• headline_angle — what the "= …" headline promises (time saved, a pain removed, a new ability, one workflow in one place). Sets card.json headline + steps. Demo: time saved ("= your standup, written before anyone opens Slack").
• broll_subject — what the timelapse b-roll shows (the product in use, the team working, a workspace, customers). Picks the --broll clip and window. Demo: the brand's own footage of work happening.
• music — the optional --bed (built from the music choice, instrumental, no artist names) or none (ship silent). Demo: driving minimal electronic, ~144 BPM.

Guardrails (enforced by render_card.py)

Two logos side by side already imply a link between the companies. The platform names another brand only as plain co-existence ("works with"), never as an endorsement, partnership or ranking. So:

1. partner.integration_confirmed: true or no card. Only when the user confirms the product really works with the partner (an integration, a plugin, an import).
2. No relationship words: partner, partnership, official, endorsed, certified, approved by, recommended by, #1, best. Say what the product does with the partner.
3. The CTA is the brand's own, never names the partner, and is never comment-bait ("comment X and I'll send the link"): nothing replies to comments.
4. Exactly two logos (square app icons, partner left), two headline lines starting "= ", four steps of 5-8 words, no em or en dashes. The renderer fails on any of these and on copy that does not fit the card at its real size.
5. Icons are real files the user supplied or confirmed: the partner's own app icon (from their site or press kit), the brand's from its kit. Never draw or generate a logo.

Rules for the b-roll

1. It is a TIMELAPSE. A locked-off real-time shot measures ~18x less motion than the reference and reads as a still photo. Use --speed (3-8x) on real footage: the brand's own clip of the product in use, a team at work, a workspace. measure_motion.py rejects a mean under 1.5.
2. Never use footage lifted from another company's ad, and never restyle one.
3. Text-to-video cannot make this shot: it renders one moment, so screens and people never change over the clip. If there is no real footage, ask the user for some.
4. Cover the band (--fit cover, the default); width leaves black around a landscape clip.
5. Flat, high-contrast screens survive; photographic wallpapers and thumbnail grids smear if the clip was ever generated or restyled.

Audio

Optional --bed (e.g. create-music-elevenlabs, instrumental, 8s), normalised to -15 LUFS with a short fade. An organic post can go out silent and take a track in-platform.