A Windows soundboard plugin for Macro Deck 3. Trigger WAV and MP3 files from your Macro Deck buttons and route playback to a selected Windows audio output.
- Play WAV and MP3 files from Macro Deck actions
- Select the Windows playback device for each sound
- Use the default Windows playback device when needed
- Adjust playback volume from 0% to 100%
- Loop sounds until they are stopped
- Monitor playback through a separate configured device
- Stop the currently playing SoundBox sound
- Refresh available playback devices while configuring an action
- Windows
- Macro Deck 3.0.0-beta.5 or newer
- .NET 10 SDK to build from source
- Download the latest SoundBox release.
- Extract the plugin package.
- Copy the package into your Macro Deck plugins directory.
- Restart Macro Deck.
- Add the Play Sound or Stop Sound action to a button.
From the repository directory, run:
dotnet restore
dotnet build -c Release
dotnet publish SoundBox.csproj -c Release -r win-x64 --self-contained true -o bin/publish/win-x64The published plugin is generated in bin/publish/win-x64.
The Play Sound action supports:
- Sound file: WAV or MP3
- Output device: a specific Windows playback device or the default device
- Monitor sound: optionally mirror playback to the configured monitor device
- Volume: 0-100%
- Loop: restart the sound automatically when it ends
The monitor device and monitor volume can be configured through the plugin configuration flow in Macro Deck.
If you find a problem or have a feature suggestion, please open an issue in this repository with:
- Your Macro Deck version
- Your Windows version
- The sound file format
- The selected output device
- Relevant Macro Deck log details
SoundBox is licensed under the MIT License.
