Tejashmakwana/motionmaxxing

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Tejashmakwana/motionmaxxing.svg?style=card)](https://bestofgithub.dev/repo/Tejashmakwana/motionmaxxing)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Tejashmakwana/motionmaxxing.svg)](https://bestofgithub.dev/repo/Tejashmakwana/motionmaxxing)

Loading README…

Rating	What it looks like on screen
Slop	A slide deck that moves: corner labels, a counter, a left headline beside a card, fades everywhere
Mid	Clean and competent, and nobody decided anything: default eases, flat grounds, a held end card
Maxxed	One idea, a world with light and texture, measured motion, cuts on motion, and gates that pass with the numbers shown

The tell	What it looks like	Caught by
Page chrome	A brand name in a corner, a "02 / SPEAK" counter, a timecode, corner brackets, a progress bar	`lint.mjs` (G5), rules C1-C6, P1
Deck layouts	A held left-aligned headline, a kicker above it, "headline left, device right"	`lint.mjs` (G5), rules C7, D1
Letter-typed headlines	A headline typed out character by character with a caret	`lint.mjs` (G5), rule T1
Vibe-coded UI cards	A rounded card with a status dot and "label . value", a "Good morning" header, zinc greys	`lint.mjs` (G5), rules V1-V5
Flat swatches	A different flat colour per scene, or a small card floating on a void	Your eyes on the contact sheet (`references/world.md`)
Dead frames	Runs of frames where nothing on screen moves	`look.py` (G2): more than 3 flat frames in a row fails
Fades everywhere	Every element arrives by opacity and every beat ends in a dissolve	Measured instead: pros use 3,392 transform entries against 584 opacity fades, and cut on motion

Finding	Measured
The median move	10 frames (0.33 s). Entries 11-12 f, opacity 6 f, blur 7-8 f
Landing vs leaving	Landing decelerates (58% ease out); leaving accelerates (37% ease in, against 16% of landings)
Overshoot	Under 9% of moves (8.8%), and late: a slow lean past the mark, not a fast spring
Arrival	Decelerates from oversize. Logos crash in from about 3.5x. Nothing grows from zero
Fades	Elements arrive by moving: 3,392 transform entries against 584 opacity fades
Cuts	Pros cut on motion, not on rest. 96% of moments use hard cuts, about 20 per moment
Dead frames	In the 3-7 s pro moments, motion on about 99% of frames (median still run: 1 frame). Whole films breathe more; the skill treats that as a question, not a target
The ending	A resolved end hold of 0.6-1.4 s; the ending usually gets smaller

Gate	Pass condition	Computed by	The vibe
G0 render exists	Decodes, is not blank, the picture moves, the length matches the plan, audio is present when planned	`look.py`	show up
G1 proof readable	UI text at least 0.04 H; the fragment at least 0.55 W or cropped by the frame; lit, in a world; magnified by the camera	by eye on the contact sheet	no squinting
G2 no empty frame	No run of more than 3 consecutive flat frames	`look.py`	mewing for your frames
G3 end card short	End hold at most 1.4 s; the final shot at most 25% of the film	`look.py`	do not overstay
G4 one hero per frame	Two panels only if one has twice the area of the other, or the camera moves between them	by eye on the contact sheet	one main character
G5 no page chrome	No corner labels, tracked-caps labels, counters, timecodes, header or footer bars, kicker over a headline, left headline block beside right-side media, progress bars, letter-typed headlines, or vibe-coded UI cards	`lint.mjs`	take the lanyard off

File	What it is
`film/final.mp4`	The film, with sound when a key is set
`film/index.html`	The editable source: plain HTML plus the `Motion` runtime, reproducible frame by frame
`film/STORYBOARD.md`	The plan: page, brand inventory, the chosen idea and why, per-act world, the beat table with what each beat buys
`film/NOTE.md`	The honest account: the idea, what is real and what is illustrative or generated, the G0-G5 numbers from the scripts, what you would still improve. The agent never certifies the film as good

Tejashmakwana/motionmaxxing

motionmaxxing

The glow-up

Why your AI video is mid

The science of the mog

The numbers a designer can use

The protocol is fundamentals

Two more findings worth stealing

The protocol

Mog check

Install

Start maxxing

Toolbox

Runtime highlights

Repo map

Built by

Ethics and credits

Status and known limits

License

Script	What it does
`scripts/providers.sh`	Reports what the machine has: Chrome, ffmpeg, key, Codex image generation, free disk
`scripts/brand.mjs`	Captures a site's brand: `brand.json`, `BRAND.md`, `board.png`, logo, fonts, screens, media
`scripts/fetch_logo.mjs`	Fetches an official mark from SVGL, Simple Icons, or the site, and never redraws one
`scripts/precedent.py`	Rule-only precedent per beat from `library/moments.jsonl` (716 rows)
`scripts/imagegen.py`	Generated surface plates, with a guard that refuses text, logos, UI and people
`scripts/voice.py`	ElevenLabs voice-over, sound effects, music, music fitting, and word alignment
`scripts/sync.mjs`	Word timings to frames, for cutting picture to the voice
`scripts/mix.py`	Voice, music and hits to one -14 LUFS / -1 dBTP mix, with predictable ducking
`scripts/render.mjs`	Deterministic frame-by-frame render through Chrome and ffmpeg; stills, shutter blur, grain
`scripts/look.py`	Contact sheet, cuts, end hold, audio audit and gates G0, G2, G3
`scripts/lint.mjs`	The page-chrome lint, gate G5
`scripts/blind_review.py`	A randomised, blind A/B page for choosing between versions