Level 2 of 3 This component, complete on its own. Its files, sources and tests are the detail below. Open the detail
Repository
film-studio
Every film in progress, by department, in one Control Room. The pattern is in docs/patterns/control-room.md, and the standard it is built to is docs/standards/stellar-standard.md. The Studio is a face on machinery that already exists: the engine (engine/filmops.py), the walkthrough engine, and the Blender and ffmpeg jobs the engine starts. It reads the engine's manifests and appends to its inboxes. It never runs a film command and never deletes a file.
This folder stands alone. It needs Node 18 or later for the Studio and Python 3 for the engine. StellarView mounts the same code at /film-studio/, and a copy installed elsewhere runs without StellarView.
Run it
node walkthroughs/film-studio/serve.mjs --port 4810 --films ~/Movies/squirrel-and-the-moon/stonehouse
# open http://127.0.0.1:4810/
Setting
Flag
Variable
When neither is set
The films root, one folder per film
--films
FILM_STUDIO_FILMS
<FILMOPS_ALBUM>/stonehouse, with the album at ~/Movies/squirrel-and-the-moon
--root Project=<films root> may repeat. Each root keeps its own album, inboxes and media checks, and the album level lists the films by project. A film name may live in one root only, and each root needs its own folder name.
readers/walkthrough.mjs reads a walkthrough-model film (a films/<film>/ folder with settings.json, lines.json and work/, rendered by that repo's films/build.mjs into media/<film>.mp4) and writes a mirror under --out. It never writes to the source. The mirror holds SCREENPLAY.md (made from the lines), ops/film-ops.json, ops/status.json and ops/progress.jsonl in the engine's shapes, and the root's ops-index.json and sources.json.
Studio contract
Read from
beats, one per line, with start and end
lines.json, timed by the render's own media/<film>.chapters.json