Reference overview
The reference section is the detailed layer under the guides: every command, option, platform value and workflow playbook. These pages are generated from the files in the Reelfold repository (the engine’s own profiles, catalogues, WORKFLOW.md playbooks and references/ notes), so they match the code. They are written in English.
If you are new, start with the guides and example prompts; come here when you need the exact value or flag.
Core reference
Section titled “Core reference”| Page | What it covers |
|---|---|
| CLI | The engine’s commands (python -m vstudio.*): intake, project, batch, cleanup, export, reframe, platform, effects, llm, retouch |
| persona.yaml options | Every option in persona.local.yaml: speeds, loudness, brand colours and theme, platform overrides, tags, voice rules, term fixes, fonts, AI routing |
| Platform specs | Each platform profile: canvas, cover sizes, length, title limits, loudness |
| Effects and themes | The effect catalogue, which engines render each effect, and the design themes |
| Caption rules | Rules for captions, cards and post copy: names, line length, emphasis, contrast |
| Messages and error codes | Every engine message code with its text and where it appears |
Workflows
Section titled “Workflows”Each workflow is a playbook the skill follows and a recipe the Mac app runs.
| Workflow | Turns… into… |
|---|---|
| talkinghead | A talking-head recording into a tight captioned short: cleanup, speed, hooks, notes panels, retouch, cover, post copy |
| promo-recut | A talking head plus screenshots, links or another video into a premium promo with split screen and highlight cards |
| longform-to-short | A lecture, webinar or livestream into a cut course video and/or short episodes or vertical slices |
| call-clips | Calls, interviews and podcasts into clips, with face masking and name-label blur |
| photo-story | Photos and a narration script (or music only) into an effect-rich story |
| vlog | B-roll into a calm, graded vlog or a fast, beat-cut one |
| explainer | A topic into a 3Blue1Brown-style animated explainer with AI narration and bilingual captions |
| polish | Any exported edit made publish-ready: cover frame, loudness, speed, optional cleanup |
| ai-video | A script or idea into AI-generated video (Kling, Seedance, MiniMax) within a credit budget |
| cover | Covers and thumbnails in each platform’s sizes |
| slides | Square or full-canvas slides for vertical videos |
| preproduction | Script writing, per-platform script checks and pronunciation drills |
| batch | Many shorts at once: plan, pilot, parallel runs, automatic checks, review, publish packages |
Engine notes
Section titled “Engine notes”Deeper notes on how the shared engine works. Useful when you script the engine, debug a result or contribute.
| Page | Topic |
|---|---|
| Intake | How a plain-language request and a pile of files become a plan |
| Projects | Recipes, items, checkpoints, the inbox, series and the publish calendar |
| Batch | Batch specs, job lists, the scheduler, QC gates, review and packages |
| Speech cleanup | Pauses, fillers, repeats and retakes: detection, the review reply, verification |
| Output edit | Second-pass editing of finished clips: ops, AI edits, undo and selective revert |
| AI providers | Routing each AI task to an API, a local model or your Claude Code / Codex login |
| Publishing | How a post reaches each platform, and why nothing auto-posts |
| Style rules | The design themes behind title bands, captions, notes and cards |
| Aesthetics checklist | The checks to run on any cut before delivery |
| Sound | Beats, sound-effect placement and levels |
| Retouch | Skin smoothing, makeup and reshape for covers and video |
| Short-video SOP | One talking-head short from topic to published post, end to end |
| Adding effects | Adding an effect to the catalogue and porting it between renderers |
| Validation | What was tested on real footage, and the known limits |