tin-computer/tin

Product demo video procedure

Everything happens through tin-studio (run tin-studio help). Work in the Studio work directory provided by the runtime (call it WORK; API runs use /home/tin-work/studio, historical OAuth runs use /home/user/.tin-lite/studio); only the finished MP4 goes into the project checkout. There is no real-time screen recording: you capture settled keyframes and the renderer synthesizes the scroll, tap, zoom, and caption motion, which is why the result is smooth.

1. Plan the story

1. Read wiki/INDEX.md (## Product, feature map, positioning). Read angle and notes.
2. Run tin-studio inspect <product_url> WORK/inspect. Read the JSON: headings with their scrollY, actions with ready-made selectors (prefer ones with inHeader: true for navigation), text, docHeight. Open WORK/inspect/inspect.png and WORK/inspect/inspect-full.png with your image viewer and note what each screen shows. Inspect one or two more pages if the story needs them (docs, pricing).
3. Decide the format script-format.md describes: one hook of at most seven words that names the pain (angle if given), then five to seven steps. Each step is one visible moment with one voice line of at most fourteen words and one caption of at most five words. Mark exactly one *word* per caption and in the hook. The last step lands on the call to action the page actually offers (trial, pricing, install) with a [warm] line. Total speech at most 75 words.
4. Claims come from the page text or project memory; numbers must be visible on screen in the step that says them.
5. Write every line as a creator talking to the viewer: present tense, second person, the thing itself. Never narrate the page ("the page shows", "this section lists", "the site's example"); say what it means for them ("your agent gets its own number"). Write amounts and counts as words, and keep brand names inside a full sentence.

2. Write and capture

1. Write WORK/script.json in the format from script-format.md.
2. Run tin-studio capture WORK/script.json WORK/out. Open every WORK/out/frames/kNNN.png with your image viewer and check: the page loaded (no blank, no error, no interstitial); no cookie banner or popup covers the content (add an early click step on its dismiss button if one appears, or choose a page without it); each scroll lands where the caption expects; each click hit the intended element (the click keyframe shows the new page). A keyframe that is wrong is a script fix: better selector from inspect, scrollTo, a bigger settleMs, or a different page. Recapture until every keyframe is right.

3. Voice

1. Run tin-studio voice WORK/out --voice <voice> --language "<language>". Add [excited] on the hook line and [warm] on the last; otherwise plain sentences. Each run prints the clip length per step; if a clip is longer than five seconds, shorten that line.
2. Voice is capped per run (24 lines, 3000 characters). Re-running keeps unchanged lines, so edit a line in WORK/script.json, recapture is not needed, and run voice again.
3. A line the provider refuses is reported as REFUSED with the reason and the other lines are kept. A content_policy_violation is the provider's opaque text checker misfiring: first run voice again without any --style of your own (the default style is known to pass), then rewrite that one line with plainer wording and run voice again. Never resend an unchanged refused line, and never spend more than two rewrites on one line; drop it and let the caption carry the step.

4. Preview, render, check

1. Character: when character is set, the file is /home/user/project/characters/<character>.svg; run tin-studio check on it first. If it is missing or rejected, render without it and say so in the message.
2. Preview three frames before the full render (hook, a mid scroll, the final step): tin-studio frame WORK/out WORK/p1.png --at 1.5 --bg <backdrop> [--character <svg>], and again at about half the total length and at the end. Look at them: captions readable and centred, the character's face visible and not covering the caption, the phone card showing the right screen, backdrop not clashing.
3. Render: tin-studio render WORK/out WORK/<slug>.mp4 --bg <backdrop> [--character <svg>]. It prints the duration. Then tin-studio check WORK/<slug>.mp4 must print OK and tin-studio probe should show 1080x1920 with an audio stream.
4. Longer than 40 seconds: cut a step or shorten lines, re-run voice, render again.

5. Deliver

Copy the checked MP4 to the declared output path and nothing else. The final message is the storyboard: hook, then per step the caption, the voice line, and what is on screen; the total duration, voice, backdrop, and character used; and any claim you softened because the page did not support it.

Rules

Never sign up, log in, fill a form, or press buy, send, delete, invite, or contact. Do not use any account. Do not capture pages behind a login. Do not edit the page's DOM to fake a state. Do not create any file in the project checkout other than the declared output.