muvid.choreo.manifest

The choreo subgenre’s manifest — visual music, declared without importing it.

Deliberately stdlib-only and free of any import from the rest of muvid.choreo: this module is what a catalogue, a UI form, an MCP tool definition or an LLM choosing among installed subgenres reads, and none of them should pay for numpy or an ffmpeg probe to do it. The renderer is named as a string and imported only when a render actually runs — the same shape as muvid.lyricvid.manifest, which is the reference plugin.

What choreo is: event-driven visual music in the Fischinger / McLaren / Gondry lineage. Audio in, nothing else. Discrete musical events (onsets, per frequency band) become objects with persistence on screen, and sections become different scene arrangements. It is choreographed and structural, not a spectrum readout — objects appear ON events and then live — which is what makes it a different thing from muvid.visualize.

Module Attributes

ARCHETYPE_NAMES	The archetype names, restated here (rather than imported from spec) so the manifest module stays free of every other choreo module.
BEAT_SOURCES	The beat-grid sources analysis knows.

muvid.choreo.manifest.ARCHETYPE_NAMES = ('fischinger', 'star_guitar', 'mclaren', 'swarm')

The archetype names, restated here (rather than imported from spec) so the manifest module stays free of every other choreo module. A test pins this tuple against spec.ARCHETYPES and scene.ARCHETYPE_FNS so the three cannot drift.

muvid.choreo.manifest.BEAT_SOURCES = ('auto', 'mixing', 'numpy')

The beat-grid sources analysis knows. auto tries mixing (librosa, in the scoring extra) and falls back to the built-in numpy estimate only when librosa is absent — a missing dependency, never a failing one.