summaryrefslogtreecommitdiff
path: root/doc/HOWTO.md
diff options
context:
space:
mode:
authorskal <pascal.massimino@gmail.com>2026-03-03 08:38:23 +0100
committerskal <pascal.massimino@gmail.com>2026-03-03 08:38:23 +0100
commitc229f3c6b5756d5cbbdad6049b4250ebea7aae7a (patch)
treecfa9be5161996d97e8d104d4a24b157a5b350783 /doc/HOWTO.md
parent11486d634c865aca944f9691e3bdb2be83adc79a (diff)
fix(build): add spectool to DEMO_BUILD_TOOLS cmake target
spectool was missing from DemoTools.cmake; scripts/gen_spectrograms.sh could not find build/spectool. Document the regeneration workflow in HOWTO.md. handoff(Claude): spectool now builds with -DDEMO_BUILD_TOOLS=ON
Diffstat (limited to 'doc/HOWTO.md')
-rw-r--r--doc/HOWTO.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/HOWTO.md b/doc/HOWTO.md
index 097f2fa..768e51d 100644
--- a/doc/HOWTO.md
+++ b/doc/HOWTO.md
@@ -242,6 +242,21 @@ audio_shutdown();
See `doc/TRACKER.md` for music system.
+### Regenerating .spec Files
+
+Converts `.wav`/`.aif` files from `tools/originals/` into `.spec` files in `workspaces/main/music/`.
+
+```bash
+# Build spectool first (requires DEMO_BUILD_TOOLS=ON)
+cmake -S . -B build -DDEMO_BUILD_TOOLS=ON
+cmake --build build -j4 --target spectool
+
+# Generate all spectrograms
+./scripts/gen_spectrograms.sh
+```
+
+Requires `ffmpeg` for `.aif` input files. Output uses v2 format (OLA, Hann, hop=256).
+
---
## Assets