# muvid

> Tools to make music videos


## Pages in this subsection

- [muvid](muvid.html.md): muvid — tools to make music videos.
- [muvid.align](muvid.align.html.md): Lyric → audio alignment.
- [muvid.characters](muvid.characters.html.md): Character cards + reference image curation via lookbook.
- [muvid.choreo](muvid.choreo.html.md): Choreo — event-driven visual music, muvid’s second subgenre plugin.
- [muvid.choreo.analysis](muvid.choreo.analysis.html.md): Turn a song into an EVENT LIST — the musical facts every archetype draws from.
- [muvid.choreo.manifest](muvid.choreo.manifest.html.md): The choreo subgenre’s manifest — visual music, declared without importing it.
- [muvid.choreo.pipeline](muvid.choreo.pipeline.html.md): The choreo pipeline — the one path from a song to a finished video.
- [muvid.choreo.render](muvid.choreo.render.html.md): Draw a `ChoreoScene` frame by frame and encode it.
- [muvid.choreo.scene](muvid.choreo.scene.html.md): The scene compiler: events + sections -> a list of drawable OBJECTS.
- [muvid.choreo.spec](muvid.choreo.spec.html.md): The choreo treatment spec — what a director decides, as data; stdlib-only.
- [muvid.choreo.tools](muvid.choreo.tools.html.md): The SSOT verbs for the choreo subgenre.
- [muvid.compose](muvid.compose.html.md): Compose all rendered shots into the final music video.
- [muvid.contracts](muvid.contracts.html.md): Adapters between muvid’s SSOT and sibling-package shapes.
- [muvid.cost](muvid.cost.html.md): Cost estimation for a muvid project.
- [muvid.data](muvid.data.html.md): Page content
- [muvid.environments](muvid.environments.html.md): Environment cards + canonical establishing image generation.
- [muvid.events](muvid.events.html.md): Surface fal progress events into the muvid project.
- [muvid.facade](muvid.facade.html.md): Top-level facade — the verbs the CLI / skill / UI all call.
- [muvid.footage](muvid.footage.html.md): Footage-aligned music video — align several device recordings of one song, assemble.
- [muvid.footage.align](muvid.footage.align.html.md): Align a set of footage clips to the song — a thin wrapper over `mixing.audio`.
- [muvid.footage.assemble](muvid.footage.assemble.html.md): Assemble validated cuts into a music video, in BOUNDED memory.
- [muvid.footage.beat_fit](muvid.footage.beat_fit.html.md): Fitting a cut’s timing to the beat — the pure numerics behind `service.fit_to_beat`.
- [muvid.footage.beats](muvid.footage.beats.html.md): Beat signals — continuous envelopes of where the beat is, in the song and in each video.
- [muvid.footage.edl](muvid.footage.edl.html.md): EDL data types + the `validate_edl` single-source-of-truth gate.
- [muvid.footage.errors](muvid.footage.errors.html.md): The refusal and cancellation types of the footage operations (`muvid.footage.service`).
- [muvid.footage.explain](muvid.footage.explain.html.md): Why each cut is where it is — the post-mortem of an edit, in plain words.
- [muvid.footage.lacing_bridge](muvid.footage.lacing_bridge.html.md): muvid project → lacing standoff records, and the DECISION tier back to an EDL.
- [muvid.footage.look](muvid.footage.look.html.md): Compile a `looks` artifact into the fragment the assembler splices.
- [muvid.footage.media_views](muvid.footage.media_views.html.md): What an editor draws: per-camera filmstrips and the song’s waveform peaks.
- [muvid.footage.music_cut](muvid.footage.music_cut.html.md): Cut footage to the music — the montage half of a music video.
- [muvid.footage.named_looks](muvid.footage.named_looks.html.md): Named looks — the camera moves and grades a person can pick for a cut.
- [muvid.footage.scoring](muvid.footage.scoring.html.md): Footage scoring — per-clip score tracks on the shared song-time grid (thorwhalen/muvid#13).
- [muvid.footage.scoring.frames](muvid.footage.scoring.frames.html.md): One decode pass per clip → the shared per-frame artifacts the quality + motion extractors
- [muvid.footage.scoring.grid](muvid.footage.scoring.grid.html.md): The song-time score grid: `ScoreTrack`, resample-to-grid, robust normalization,
- [muvid.footage.scoring.lipsync](muvid.footage.scoring.lipsync.html.md): Lip-sync tier (OPT-IN, OFF BY DEFAULT): SyncNet LSE-C vs the master’s Demucs vocal stem.
- [muvid.footage.scoring.motionbeat](muvid.footage.scoring.motionbeat.html.md): Motion-to-beat tier: `motion_beat_bas` + `motion_onset_xcorr` → song-grid tracks.
- [muvid.footage.scoring.orchestrator](muvid.footage.scoring.orchestrator.html.md): The scoring orchestrator: a project (song + aligned clips) → the persisted score tensor.
- [muvid.footage.scoring.quality](muvid.footage.scoring.quality.html.md): Quality tier: sharpness / exposure / stability_shake / face_framing → song-grid tracks.
- [muvid.footage.scoring.segment](muvid.footage.scoring.segment.html.md): Shot boundaries (PySceneDetect) + the per-clip coverage mask.
- [muvid.footage.select_score](muvid.footage.select_score.html.md): The score-driven `weighted` selection strategy: a beat-snapped semi-Markov Viterbi DP.
- [muvid.footage.service](muvid.footage.service.html.md): The footage operations — one function per thing you can do to a music-video project.
- [muvid.footage.strategy](muvid.footage.strategy.html.md): The pluggable `SelectionStrategy` registry — alignments → an EDL.
- [muvid.footage.workspace](muvid.footage.workspace.html.md): Per-user, STATEFUL project for the footage-aligned `music_video` genre.
- [muvid.importing](muvid.importing.html.md): Bring a finished production into a host’s projects dir as a `muvid.Project`.
- [muvid.lyrics](muvid.lyrics.html.md): Lyrics — transcription and markdown round-trip.
- [muvid.lyricvid](muvid.lyricvid.html.md): Lyric video (kinetic typography) — muvid’s first subgenre plugin.
- [muvid.lyricvid.captions](muvid.lyricvid.captions.html.md): Caption tracks: one subtitle file per language, timed per sung line (muvid#145).
- [muvid.lyricvid.director](muvid.lyricvid.director.html.md): The creative director — a song in, one or more `TreatmentSpec`s out.
- [muvid.lyricvid.glyph_align](muvid.lyricvid.glyph_align.html.md): Per-glyph timing: when was each written character sung? (muvid#142)
- [muvid.lyricvid.manifest](muvid.lyricvid.manifest.html.md): The lyric-video subgenre’s manifest — muvid’s own first plugin.
- [muvid.lyricvid.pictures](muvid.lyricvid.pictures.html.md): Pictures for a lyric video: a mosaic that builds up as its words are sung (muvid#151).
- [muvid.lyricvid.pipeline](muvid.lyricvid.pipeline.html.md): The lyric-video pipeline — the one path from a song to a finished video.
- [muvid.lyricvid.render_ass](muvid.lyricvid.render_ass.html.md): The default lyric-video renderer: a `Scene` as ASS.
- [muvid.lyricvid.render_web](muvid.lyricvid.render_web.html.md): The web backend: a `Scene` as a deterministic
- [muvid.lyricvid.scene](muvid.lyricvid.scene.html.md): The renderer-neutral scene — every number computed, no renderer opinions.
- [muvid.lyricvid.shape](muvid.lyricvid.shape.html.md): Packing words INSIDE a shape — the shape-word-cloud construction.
- [muvid.lyricvid.spec](muvid.lyricvid.spec.html.md): The treatment spec — what a director (human or model) decides, as data.
- [muvid.lyricvid.timed_text](muvid.lyricvid.timed_text.html.md): The timed text tree — song → sections → lines → words, with measured times.
- [muvid.lyricvid.tools](muvid.lyricvid.tools.html.md): The SSOT verbs for the lyric-video subgenre.
- [muvid.mcp](muvid.mcp.html.md): muvid MCP server — the `music-visualizer` tool surface for a remote connector.
- [muvid.mcp.footage_tools](muvid.mcp.footage_tools.html.md): MCP tools for the footage-aligned `music_video` genre (thorwhalen/reelee#229).
- [muvid.mcp.identity](muvid.mcp.identity.html.md): Caller identity for the muvid MCP tools — resolved from the OAuth token, fail-closed.
- [muvid.mcp.scoring_tools](muvid.mcp.scoring_tools.html.md): MCP tools for the footage SCORING layer (thorwhalen/muvid#13).
- [muvid.mcp.workspace](muvid.mcp.workspace.html.md): Per-user output bucket for the muvid `music-visualizer` MCP genre.
- [muvid.montage](muvid.montage.html.md): Montage — a beat-cut video from a pool of stills and clips (subgenre plugin).
- [muvid.montage.analysis](muvid.montage.analysis.html.md): Measure the song and the pool: beat grid, bars, sections, and media strength.
- [muvid.montage.manifest](muvid.montage.manifest.html.md): The montage subgenre’s manifest — a beat-cut montage from a pool of stills and clips.
- [muvid.montage.pipeline](muvid.montage.pipeline.html.md): The montage pipeline — the one path from a song and a pool to a finished video.
- [muvid.montage.plan](muvid.montage.plan.html.md): The planner: a pool of media + a beat grid + sections -> an edit list of slots.
- [muvid.montage.render](muvid.montage.render.html.md): Render a `Plan` to a YouTube-spec mp4 with ffmpeg.
- [muvid.montage.spec](muvid.montage.spec.html.md): The montage treatment spec — what a director (human or model) decides, as data.
- [muvid.montage.tools](muvid.montage.tools.html.md): The SSOT verbs for the montage subgenre: analyze, plan, render.
- [muvid.paths](muvid.paths.html.md): The ONE place muvid decides where its data lives.
- [muvid.project](muvid.project.html.md): Project facade — folder layout, persistence, and a small `dol`-backed mall.
- [muvid.renderers](muvid.renderers.html.md): Render dispatch — turn a single ShotSpec into `shots/<id>/output.mp4`.
- [muvid.renderers.animation](muvid.renderers.animation.html.md): Render strategy: animation — handoff to the `an` package.
- [muvid.renderers.image_to_video](muvid.renderers.image_to_video.html.md): Render strategy: image_to_video.
- [muvid.renderers.lipsync](muvid.renderers.lipsync.html.md): Render strategy: lipsync.
- [muvid.renderers.still](muvid.renderers.still.html.md): Render strategy: still — a single image held for the shot duration.
- [muvid.renderers.text_to_video](muvid.renderers.text_to_video.html.md): Render strategy: text_to_video. Pure prompt → video clip.
- [muvid.schema](muvid.schema.html.md): Schema for an muvid project — the SSOT data shapes.
- [muvid.script](muvid.script.html.md): Script (screenplay) markdown ↔ ShotSpec list.
- [muvid.subgenres](muvid.subgenres.html.md): muvid subgenres — the plugin surface for *another kind of video*.
- [muvid.subgenres.testing](muvid.subgenres.testing.html.md): A conformance kit for subgenre plugin authors.
- [muvid.ui](muvid.ui.html.md): Minimal local web UI for an muvid project.
- [muvid.visualize](muvid.visualize.html.md): Turn a song (+ optional cover) into a visualizer music video.
- [muvid.visualize.canvas](muvid.visualize.canvas.html.md): Lay a cover image out on a 16:9 canvas, and derive a thumbnail from it.
- [muvid.visualize.ffmpeg](muvid.visualize.ffmpeg.html.md): Low-level ffmpeg/ffprobe primitives shared across `muvid.visualize`.
- [muvid.visualize.reactive](muvid.visualize.reactive.html.md): Precomputed audio-reactivity: pulse a video filter in time with the music.
- [muvid.visualize.verify](muvid.visualize.verify.html.md): Check a rendered music video against what YouTube actually wants.
- [muvid.visualize.video](muvid.visualize.video.html.md): Render an audio file into a video: pick a visual, mux, normalize, encode.
- [muvid.visualize.visuals](muvid.visualize.visuals.html.md): Visual strategies: how the *picture* of an audio-driven video is produced.

## Optional

- [Top-level llms.txt](../llms.txt): Complete documentation index.