Build an In-Game Soundboard

/sim/audio lets ordinary Linux userland play through KSA’s FMOD mixer. Upload a clip, name the channel, then change it while it is playing.

Upload and play

/sim (in guest)

cat launch.ogg > /sim/audio/file/launch.ogg
echo 'launch.ogg id=launch vol=0.7 group=sfx' > /sim/audio/play

HTTP (host)

curl -T launch.ogg http://127.0.0.1:4242/v1/audio/file/launch.ogg
curl -X POST --data 'launch.ogg id=launch vol=0.7 group=sfx' \
  http://127.0.0.1:4242/v1/fs/audio/play

Mix it live

echo 'launch vol=0.25 pitch=0.9' > /sim/audio/set
cat /sim/audio/status
echo launch > /sim/audio/stop

Use loop=1 for music, start= and end= for a range in milliseconds, and pan= for placement. group=sfx|music|ui chooses which KSA volume slider governs the channel.

Memory, not a jukebox disk

Uploaded clips live in mod memory. They are bounded by clip, store, count, and concurrent-channel caps. Remove a stored clip with rm /sim/audio/file/<name>.

Validation status

Audio is code-complete and unit-tested; its live KSA playback checklist is pending.

The the90s example turns this into a proper terminal soundboard, naturally styled like software recovered from a mall kiosk.

Audio referenceFormats, upload routes, play/set/stop grammar, events, limits, and errors.