Repository navigation
The Pipeline
A film moves through files in one project folder. The worked example has each one.
| Step | File | Skill |
|---|---|---|
| Brief | brief.md |
cinewright |
| Script | script.md |
cinewright-script |
| Design | design.md |
cinewright-design, cinewright-sets
|
| Bibles |
bibles/style.json, characters.json, locations.json, scenes.json, optional props.json and voices.json
|
cinewright-design, cinewright-camera, cinewright-voice
|
| Shot cards |
cards/<slate>.json, one per shot |
cinewright-shots |
| Continuity |
continuity diff before any render |
cinewright-continuity |
| Prompts |
compiled/<model>/<slate>.txt and .params.json
|
cinewright-genvideo |
| Takes |
takes/<card>-<n>.json, review with qc
|
cinewright-qc |
A video model sees one prompt and knows nothing about the shot before it. The bibles hold what must not change (a face, a scar, a coat, the light's direction); the card holds what this shot does (size, angle, camera azimuth, move, lens, action). The compiler pastes the bible text verbatim into every prompt, so the description of a character never drifts between shots.
continuity diff checks every card against the bibles and the card before it. The camera azimuth on each card places it on one side of the line between the characters; a card on the other side flips left and right, and its eyelines must flip too. In the example, the planted card puts the camera at side B and is refused with an AXIS and an EYELINE error (Commands). A deliberate cross is allowed with crosses_axis and a cross_reason.
A style file (--style) swaps the look: lighting, frame aspect, lens family, allowed moves and a film-history card. The diff then warns LENS for a card lens outside the lens family and MOVE for a move the style does not allow.
takes lastframe extracts a take's last frame as the next card's start, so a continuing shot begins where the last one ended. qc reviews the take: a contact sheet, spec against the card, loudness, and a rubric whose verdicts come back as the cheapest fix on the repair ladder (one change per reroll).
This wiki describes cinewright 0.3.0 and was last updated on 2026-11-05. The plugin is MIT licensed. Report problems in the issues.
Using it
The releases
Contributing
Elsewhere