Drive the Audio Forge soundboard from Foundry VTT over Audio Forge's Local API (HTTP + WebSocket). No cloud account or MQTT broker.
- Scene audio: attach an audio profile to a scene (restore a saved Audio Forge state, or pick music and ambiance). It runs when the scene is activated, or on demand from the panel.
- Combat audio: separate profiles for combat start and combat end.
- GM control panel (sound controls button, or
Alt+A): play/pause/stop/next per section, volumes, category toggles, echoes, saved states, library switch. - Online room: your players hear your Audio Forge output inside Foundry, with nothing to install. The room opens by itself while players are connected and closes when everyone has left. You see who is in, who was turned away because the room is full, and can remove players or connect them on demand.
- Macro API:
game.modules.get("audioforge").api.
Only GM clients connect to Audio Forge; each GM talks to the Audio Forge on their own machine. Players only connect to the Audio Forge Rooms server, and only when you open a room.
In Foundry: Add-on Modules > Install Module, paste this manifest URL, and install:
https://github.com/Slashpaf/audioforge-foundryvtt/releases/latest/download/module.json
Requires Foundry VTT v13 or newer. Tested on v14; v13 uses the same APIs but has not been run.
- Audio Forge: Settings > Local API, enable the server (default port
8329). - Install this module and enable it in your world.
- Module settings: host
localhost, port8329. An API key is only needed for a non-local Audio Forge (also enable LAN access in Audio Forge).
The Local API is plain http:///ws://. Browsers allow that to localhost even from an HTTPS Foundry (recent Chrome versions may ask for local-network permission), but block it to any other host. If Foundry is served over HTTPS and Audio Forge is on another machine, the panel shows a "Blocked" message; serve Foundry over HTTP on that network instead.
- Scene: right-click a scene in the Scenes directory > Scene audio, or use the header button in Scene Configuration.
- Combat: module settings > Combat start audio / Combat end audio.
A profile does one of: nothing, restore a saved state, or pick music and ambiance. Ambiance changes are explicit on/off commands (Audio Forge's own play toggles ambiance), so re-applying a profile never switches things off by accident. Use Test now in the editor to try it without saving.
Needs an Audio Forge account signed in on the GM's machine. The player list and removing people need a recent Audio Forge; with an older version the room still opens and plays, without those two.
- It opens by itself. When the first player connects, the room opens with the password you last used. A minute after the last player leaves it closes, unless someone else is still in it (for example a guest who joined with the link). A room you open yourself is never closed for you, and one you close by hand stays closed until all players have left once. Turn this off in the module settings (Open the online room while players are connected) to open and close it yourself.
- Opening it by hand. In the panel, click the broadcast button, optionally set a password, and Open room. Your players are told over Foundry's socket, join on their own and hear your master output. Nobody needs the link.
- Room limits. Free Audio Forge rooms have a listener limit. Players who do not fit show as Waiting and you get a notification. Remove someone, then connect the waiting player (the player button in the room window). Subscribing to Audio Forge in the app removes the limit.
- Others in the room. Anyone else who finds the link and joins shows under Others in the room; remove them from there, or from the Audio Forge app.
Players can leave, rejoin and change the volume from the broadcast button in their scene controls. They join automatically unless they turn that off in their own module settings. Audio stays silent until the player has clicked somewhere in Foundry (a browser rule); the window offers a button when that is the case.
const af = game.modules.get("audioforge").api;
await af.play("Music", "Battle");
await af.playEcho("Thunder");
await af.setVolume("Ambiance", 0.6); // 0..1, as shown in the app
await af.restoreState("Tavern night");
await af.send({ command: "stop", section: "All" }); // any Local API commandHooks: audioforge.connection(connected), audioforge.state(state).
See CONTRIBUTING.md for how to contribute.
npm install
npm test # client + profile logic against a mock Local API serverSymlink this folder into Data/modules/audioforge. The UI has been run on Foundry v14 with Audio Forge on the same machine. The code targets the v13 API, but v13 itself is untested.
Releases: bump version in module.json, push a matching vX.Y.Z tag, and the workflow creates a draft release with module.json and module.zip for review. Publish the draft so the latest/download manifest URL resolves.
MIT for the code. Audio Forge's name, branding and the bundled logo glyph are not covered; see ASSET_LICENSE.md.