ReMapping — manuals and working notes

ReMapping is the film system in ~/Documents/Remapping: a production is a folder, a film is Python, and the renderer plans it, renders frame ranges, encodes segments, joins them, mixes audio, and verifies the delivered file against an output profile before it is allowed into outputs/. These three notes are everything currently written about it.

In one line. Read the rendering guide to operate the system, the implementation requests to see what is being changed, and My Comments for the running log of what broke and what was fixed.

Full text of all three notes — try profile, draft-timing, anchors, stems, narration. Press / to jump here, Enter to open the top hit, Esc to clear.
The three notes
Rendering & output guide
How to inspect, preview, render, verify and configure a production. The full command reference, the three render modes, output profiles, and job recovery. Start here to operate the system.
Implementation requests
Three specified changes, each with a cause, a required fix and acceptance criteria: the guided voice studio, the still-render overlay bug, and high-frame-rate output profiles.
Production log
The running notebook: setup commands, open cases, music references, and the issue list — open above, fixed below.

The pipeline in one picture

Every command in the guide sits somewhere on this line. The rule of thumb is to work top to bottom and never skip the cheap checks — a still costs seconds, a full render costs considerably more.

Figure 1: The production pipeline, cheapest check first. Validate and inspect report only; everything from still downwards writes files into the production.

Current state

ItemKindState
Guided voice-recording studiofeaturerequested
Diagnostic overlays in stillbug — cause knownopen
High-frame-rate output profilesfeaturerequested
Outline on textopen caseto check
Tracking on mathopen caseto check
Framing outline · Camera3D qualityissuesfixed
Table 1: What is open right now. The three requests are specified in full in their own note; the two cases are still questions rather than tasks.

Getting to a production quickly

cd ~/Documents/Remapping
source .venv/bin/activate

# make a new production
uv run remapping production new productions/my-film --id my-film

# the cheap checks, in order
uv run remapping production validate productions/my-film
uv run remapping film inspect productions/my-film
uv run remapping still productions/my-film --scene title --time 1

The full sequence, all the options, and what each render mode is for are in the rendering guide.