/render-logo-equation-card

name: render-logo-equation-card
description: Render the logo-equation card ad (7s, 9:16) — partner icon + brand icon joined by a plus sign as an equation, a two-line "= outcome" headline, four numbered steps, and a CTA that hard-cuts in at 2s, on a static black card over timelapse b-roll, no voice. render_card.py draws the two card plates with measured geometry and hard guardrails (the user must confirm the integration is real, no partnership/endorsement/ranking words, no comment-bait CTA, no dashes); compose.py lays the card over the b-roll sped up to read as a timelapse, with an optional bed; measure_motion.py gates the b-roll (a real-time shot reads as a photo). Free, local.
status: active

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.