Music
Turn a short description or a pasted score into one looping WAV.
1. Write the score
Use the MML subset in ${CLAUDE_PLUGIN_ROOT}/scripts/mml.py: t tempo, o
octave, l length, v volume 1-15, @0 bass, @1 to @4 pulse duties 12.5, 25, 50, 75
(claim = those four duties; basis = chips.md; as of
2026-09-28; recheck when that file's Pan Docs or NESDev basis changes), < and
> for octave, [ ] repeats, | between parts, n for noise. Notes are a through g and
r. Presets cap channels and noise parts only, not the hardware voice mix, and pico-8 shares the
Game Boy and NES duties. A dot after a length is 1.5 times. Pick --chip gameboy, nes, or
pico-8. Four parts at most, and only one part may use n.
A worked loop is ${CLAUDE_PLUGIN_ROOT}/examples/campfire.mml.
2. Render
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/mml.py" --chip gameboy --out <dir>/loop.wav "<score>"
3. Deliver
Give the WAV path and the score text beside it. A pixel-art scene takes the path as its audio argument and inlines the file. Do not edit that plugin from here.
Next
/pixel-art:scene to play the loop in a scene.
Gotchas
- Length numbers are denominators:
l4is a quarter note,l8an eighth. - The renderer does not write MP3.