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

FileWhat it is
template/promo.htmlA loop: one object travelling through the product’s surfaces, a real cursor, 3D in WebGL.
template/reel.htmlA long film on a timeline: six scenes, six formats, five transitions, a look per chapter.
template/film.jsThe stage (subpixel jitter), rasters that hold still, springs and cameras, the timeline, transitions, effects.
template/fx.jsThe looks: backdrops, fields, pictures, light, texture, glass, click ripples, palettes, chapter sequences.
template/type.jsHeadlines: thirteen styles of arrival, an emphasis, a pace, TYPE.load for a family’s faces.
template/parts.jsVector 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.htmlA “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

ScriptWhat it does
render.mjsstills, sheet, looks, loopcheck, video, beats: formats, chapters, resumable chunks, the heat governor, the beat check.
beats.mjsA soundtrack’s tempo, beats, bars and sections, from its samples; the bpm and AUDIO_AT that put the film on its beat.
voice.mjsA story told by a voice model on the Mac instead of say; --setup once on each Mac, --audition to compare takes.
narrate.mjsA tutorial’s story into a voice, a clock and subtitles: narration.wav, narration.js, captions.srt and .vtt.
mix.mjsA voice and a music track into one soundtrack: the music measured under the voice, up between lines.
deliver.mjsThe finished films into a folder of their own, and the work folder to the Trash once its source is safe.
contact.mjsA captioned contact sheet of a folder of stills.
clickcheck.mjsIs every click seen: the camera still, the cursor at rest before the press and through it.
fonts.mjsAnother family for the kit, from Google Fonts with its licence; check, list.
thermo.swiftThe 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.