⚠️ Legal Notice: This tool processes audio you provide. You are responsible for ensuring you have the rights to use the source material. The authors make no claims about fair use, copyright, or derivative works regarding your use of this tool with copyrighted material.

Strudel Music 🎵

Compose, render, deconstruct, and remix music using code. Takes natural language prompts → writes Strudel patterns → renders offline through real Web Audio synthesis → posts audio or streams to Discord VC (via the OpenClaw gateway — no separate credentials needed). Can also reverse-engineer any audio track into stems, samples, and generative programs.

New here? Read docs/ONBOARDING.md for a ground-up introduction.

⚠️ SESSION SAFETY — READ THIS FIRST

Rendering MUST run as a sub-agent or background process, never inline in your main session.

The offline renderer (chunked-render.mjs / offline-render-v2.mjs) runs a tight audio-processing loop that blocks the Node.js event loop. If you run it in your main OpenClaw session, it will kill the gateway after ~30 seconds (the heartbeat timeout).

✅ Correct: spawn a sub-agent or use background exec
❌ Wrong:   run the renderer inline in your main conversation

Always do this:

# Background exec with timeout
exec background:true timeout:120 command:"node src/runtime/chunked-render.mjs src/compositions/my-track.js output/my-track.wav 20"

Or spawn a sub-agent:

sessions_spawn task:"Render strudel-music composition: node src/runtime/chunked-render.mjs ..."

This is the #1 way to break things. Don't skip this.

Quick Start

# 1. Setup
cd ~/.openclaw/workspace/strudel-music
npm run setup              # installs deps + downloads samples (~11MB)

# 2. Verify
npm test                   # 12-point smoke test

# 3. Render
node src/runtime/chunked-render.mjs assets/compositions/fog-and-starlight.js output/fog.wav 16
ffmpeg -i output/fog.wav -codec:a libmp3lame -b:a 192k output/fog.mp3

Commands

Composition Workflow

1. Parse prompt → select mood, key, tempo, instruments (see references/mood-parameters.md)
2. Write a .js composition using Strudel pattern syntax
3. Render (in background!):

   node src/runtime/chunked-render.mjs <file> <output.wav> <cycles> [chunkSize]
   

4. Convert to MP3:

   ffmpeg -i output.wav -codec:a libmp3lame -b:a 192k output.mp3
   

5. Post the MP3 as attachment or stream to Discord VC

Discord VC Streaming