From f5bd7ae13ce2aff47f153be47eda37ae936727e4 Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Sat, 17 Oct 2026 08:56:47 +0000 Subject: [PATCH] =?UTF-8?q?AGENTS.md:=20correct=20rendering=20docs=20?= =?UTF-8?q?=E2=80=94=20FluidR3=20is=20MIT=20(size,=20not=20licence),=20add?= =?UTF-8?q?=20OPL3=20route?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index cc25161..5e2ee96 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -72,8 +72,15 @@ to ticks at 480 tpq. ## Rendering -Needs `timidity` + a GM soundfont (e.g. FluidR3_GM.sf2, not bundled — -licensing). Debian's timidity: use `-Ow -s 44` (no `-O2` mode). +Two routes, both verified: +- **Sample-based**: `timidity -Ow -s 44 in.mid -o out.wav` + a GM soundfont. + FluidR3 is MIT-licensed and one command away: `apt install fluid-soundfont-gm` + (148MB; lighter: `timgm6mb-soundfont`, ~6MB). Not bundled in-repo because of + size, not licence. Debian's timidity: use `-Ow -s 44` (no `-O2` mode). +- **OPL3 FM (authentic DOS sound, no soundfont)**: `./tools/opl/build.sh` + once (needs cmake+g++, fetches libADLMIDI), then `./tools/render_opl.sh`. + `OPL_MODEL=` env picks a game-driver volume model: 3 DMX/Doom (default), + 4 Apogee/Duke Nukem 3D, 2 id-style, 8 AIL, 10 HMI. Output is normalised. ## Known gotchas