Reference
By hand
The quick start without Claude, the files of the engine and the scripts: render, beats, voice, mix and deliver.
Everything Claude does goes through scripts you can run yourself, from the skill’s folder. The skills’ SKILL.md files are the method (how to ask, storyboard, source the brand, direct, verify); this page is the tooling.
Quick start
W=~/Downloads/acme-promo-work && mkdir -p $W/src
cp template/{reel.html,film.js,fx.js,parts.js,type.js} scripts/{render.mjs,contact.mjs,deliver.mjs,clickcheck.mjs,thermo.swift} $W/src/
cd $W/src && npm i playwright-core
PAGE=reel.html node render.mjs sheet sheet && node contact.mjs sheet sheet.png 4 # stills to review
PAGE=reel.html PREVIEW=1 node render.mjs video ../draft.mp4 # a draft, ~16x faster
PAGE=reel.html node render.mjs video ../acme-promo.mp4 # the master
PAGE=reel.html node render.mjs stills stills 0 # its cover
node deliver.mjs ~/Downloads/acme-promo ../acme-promo.mp4 stills/t00.00.png=acme-promo-poster.png
DRY=1 node deliver.mjs trash $W --kit <repo>/scripts/film # once the film is out
What is in it
| File | What it is |
|---|---|
template/promo.html | A loop: one object travelling through the product’s surfaces, a real cursor, 3D in WebGL. |
template/reel.html | A long film on a timeline: six scenes, six formats, five transitions, a look per chapter. |
template/film.js | The stage (subpixel jitter), rasters that hold still, springs and cameras, the timeline, transitions, effects. |
template/fx.js | The looks: backdrops, fields, pictures, light, texture, glass, click ripples, palettes, chapter sequences. |
template/type.js | Headlines: thirteen styles of arrival, an emphasis, a pace, TYPE.load for a family’s faces. |
template/parts.js | Vector parts: a macOS window, a browser, a terminal, an iPhone, a MacBook, keycaps, a switch, a ring. |
template/fonts/ | Twenty open-licensed families with their licences, and fonts.json. |
../release-film/template/release.html | A “what’s new” film: the change happening in place, on a version card. |
studio/ | The Studio: server, wizard, stage.html, schema.json, studio.json, its self-tests. |
The scripts
| Script | What it does |
|---|---|
render.mjs | stills, sheet, looks, loopcheck, video, beats: formats, chapters, resumable chunks, the heat governor, the beat check. |
beats.mjs | A soundtrack’s tempo, beats, bars and sections, from its samples; the bpm and AUDIO_AT that put the film on its beat. |
voice.mjs | A story told by a voice model on the Mac instead of say; --setup once on each Mac, --audition to compare takes. |
narrate.mjs | A tutorial’s story into a voice, a clock and subtitles: narration.wav, narration.js, captions.srt and .vtt. |
mix.mjs | A voice and a music track into one soundtrack: the music measured under the voice, up between lines. |
deliver.mjs | The finished films into a folder of their own, and the work folder to the Trash once its source is safe. |
contact.mjs | A captioned contact sheet of a folder of stills. |
clickcheck.mjs | Is every click seen: the camera still, the cursor at rest before the press and through it. |
fonts.mjs | Another family for the kit, from Google Fonts with its licence; check, list. |
thermo.swift | The chip’s temperature without sudo, for the governor. |
Sound, from the command line
node beats.mjs track.mp3 # the track's tempo, bars and sections
node voice.mjs --setup chatterbox orpheus # once on each Mac
node voice.mjs story.json # a voice model tells the story
node mix.mjs --voice narration.wav --music track.mp3 --out mix.wav
node deliver.mjs ~/Downloads/acme-promo ../acme-promo.mp4 # the finished film, into its own folder
Each script documents its options at the top of its file, and deliver.mjs --selftest and beats.mjs --selftest drive their own checks. studio/selftest.mjs, from a folder with playwright-core, drives the Studio through all ten steps in headless Chrome without opening a visible window or touching your prefs.