Skip to content

A local video studio for your coding agent. Describe a video in one sentence: your agent directs, your machine renders. Claude Code, Codex, Cursor, Devin and more. No API keys, no uploads.

7.6 KB
Raw Blame

showtime glossary

One word per idea, used the same way in SKILL.md, references, CLI help, printed output and code. When a sentence needs one of these ideas, use the term below; the Avoid: words are near-synonyms that have caused confusion. Avoid-words in backticks are audited: scripts/check_release.py warns when SKILL.md or a reference uses one. Plain avoid-words are guidance only, because they have other legitimate meanings elsewhere (a "slide" transition, music "sections").

Where things live

project

A folder with showtime.json + index.html (plus assets) that showtime render turns into a video. Claude authors it; it is the source, never an output. Created with showtime new <template> <dir>. Avoid: comp, composition folder, workspace

job

One request carried out end to end, with its own output folder showtime-out/<slug>-<timestamp>/: final.mp4, poster.jpg, share.txt, exports/, work/ (intermediates and logs), SHOWTIME.md (where the job stands) and job.json (versions, timings, warnings, and outputs: the latest file of each kind). <job> in commands and docs is that folder as showtime job init prints it; its name also works (launch = the newest launch-<timestamp> job). A job may contain or point to a project; a footage edit job has no project at all (its EDL lives in <job>/edit/). Avoid: run folder, output project, session folder

template

A starter project copied by showtime new (dom, film, short, tutorial, data). Avoid: boilerplate, starter kit, theme (a theme is a colour/type token set inside a project)

Time structure (largest to smallest)

scene

A section of the video with one idea or message ("the problem", "the demo", "the call to action"). In HTML projects a scene is usually one [data-start][data-dur] element; in footage edits it is a run of segments. Avoid: slide deck page, slide, part, chapter (chapters are YouTube timestamps in share.txt)

shot

One continuous view inside a scene: a camera angle, a screen recording segment, a zoom target. Cuts happen between shots. Avoid: take (a take is one recording of the same material; you choose between takes)

clip

A time window on the stage timeline: any element with data-start and data-dur that the clips adapter shows and hides. A clip can hold a whole scene or one caption line. Avoid: timeline layer, track (tracks belong to the audio mix)

beat

A moment something should land: a word in the voice-over, a music downbeat, a sound-effect hit, a reveal. Beats are timestamps; animation and cuts are aligned to them. Avoid: cue point, sync point, marker

slot

A narration line's share of the timeline in voice/timeline.json: from the line's start to the next line's start, so it includes the pause (the last slot includes the tail). showtime retime --from-voice makes each narrated scene its lines' slots plus a short pad of picture before the first line. Avoid: line window, voice segment

Versions of the output

first look

The first thing the user sees, within minutes: a contact sheet of stills (showtime snap) and/or a draft. Its job is to catch a wrong direction early, not to impress. Avoid: sneak peek, teaser (a teaser is a kind of video)

draft

A fast, low-cost render for review: showtime render --preview (quick encode) or a lower --scale. Timing and content are real; quality is not. Avoid: proxy render, rough cut (reserve for footage edits before polish)

preview

Watching a project live in the browser player (showtime preview): scrubber, frame stepping, audio, no file written. Avoid: preview file, preview render (a quick file is a draft, even when named preview.mp4)

final

The full-quality render the QA gate (showtime qa) passed: final.mp4, or the job's latest final (final-2.mp4 after a re-render, final.poster.mp4 after a poster bake; renders never overwrite). Platform versions made from it are exports. Avoid: release cut, final master, master (reserved for audio)

Sound

mix

Combining tracks (voice, music, effects, ambience) with levels, ducking and timing into one audio file, described by audio/mix.json and rendered by showtime audio mix. Avoid: soundtrack, blend (voice blends are a different thing)

master

The last audio step: loudness to the delivery target (-14 LUFS by default) under a true-peak ceiling (-1 dBTP), with the AAC encode re-checked. showtime audio master. Only audio is mastered. Avoid: final mix, normalise (normalising is one part of mastering)

score

Music generated by the project itself with Web Audio (ST.score / Synth.score), rendered offline in sync with the frames. showtime score renders only the score. Avoid: procedural track, generated soundtrack

bed

A music track placed under the video: composed with showtime audio compose, taken from the local library, or supplied by the user. It is one track in the mix. Avoid: BGM, background music file, loop (a loop is a way of filling time)

Studio mode (deciding together)

style frame

One still that fixes the look of a video: palette, type, layout, texture. Several style frames are shown so the user can pick a direction. Avoid: moodboard image, concept art, mockup

board

A page in the local studio server that shows options (concepts, style frames, storyboards, sound samples) with pick buttons and a feedback box. Avoid: studio dashboard, studio gallery, canvas (canvas is the HTML drawing surface)

storyboard

The planned scenes in order, one frame and one line of intent each, before anything moves. Avoid: shot list (a list without frames), script (the words)

animatic

The storyboard timed to the voice-over and music as a moving draft: stills or rough motion, real timing. The last hard stop before the full build. Avoid: pre-vis, previs, rough animation

brand kit

Optional per-project facts about the brand (brand.json / brand.md): name and pronunciation, logo, colours, fonts, voice, formats, words to avoid. Read when present, never required. Avoid: brand pack, brand profile, style guide (a larger document the kit may be derived from)

How showtime works with the user

quick mode

The default: at most one or two decisive questions (each with a recommended answer), then a first look, then the final. Assumptions are stated, not asked. Avoid: auto mode, express mode

studio mode

Opt-in, for high-stakes or open-direction work: boards and hard stops at concepts, storyboard and animatic, with decisions logged in studio/decisions.md. Avoid: pro mode, collaborative mode, interactive mode

Install vocabulary

tier

How much showtime setup installs: minimal (CI), core (default), full. Avoid: install profile, edition

extra

An optional feature installed on request with showtime setup --with <name> (for example asr-turbo, diarize, sf-generaluser). Features that need a missing extra say so and print that exact command; nothing is installed silently. Avoid: add-on, addon, plugin (the whole of showtime is the plugin)

Flagged ambiguities

  • "Preview" means the live browser player, never a file. A quick file is a draft.
  • "Master" means the audio step. The picture-and-sound deliverable is the final; its platform versions are exports.
  • "Take" is a recording of the same material (choose between takes); a shot is a view within a scene (cut between shots).
  • "Track" is audio (the mix has tracks); the stage timeline has clips.
  • "Theme" is a token set used inside a project (colours, fonts, motion speed); a template is a starter project; a brand kit is the customer's facts.