DiscordSoundboard

DiscordSoundboard

Docker app from Darkside138's Repository

Overview

Simple soundboard for discord. You can trigger sounds by commands typed in the Discord chat, or you can choose the sound from the web UI. You will need to create a bot account that the bot will use to join and play sounds. The bot can only play sounds/respond to commands for servers it has been given access. Get your bot token from here - https://discord.com/developers/applications. This will not work correctly without a proper Bot Token and the bot application being added to your discord server. Join the official discord: https://discord.gg/kZTNtfW for support

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Bot TokenVariable

Container Variable: bottoken Help on how to get a bot token: https://github.com/Darkside138/DiscordSoundboard/wiki

Target
bottoken
Discord UsernameVariable

Container Variable: username This is the name of the bot owner.

Target
username
Value
Darkside
Sound DirsPathrw

Container Path: Point to a directory of .mp3/.wave files to make accessible in the bot.

Target
/etc/DiscordSoundboard/bin/sounds
Value
/mnt/user/SoundboardSounds/
Web Interface PortPorttcp

Container Port: 8080

Target
8080
Value
8585
Database PathPathrw

Container Path: /etc/DiscordSoundboard/bin/discordDB

Target
/discordDB
Default
/mnt/user/appdata/DiscordSoundboard
Value
/mnt/user/appdata/DiscordSoundboard/db
ApplicationConfigPathrw

Container Path: /etc/DiscordSoundboard/config

Target
/etc/DiscordSoundboard/config
Default
/mnt/user/appdata/DiscordSoundboard
Value
/mnt/user/appdata/DiscordSoundboard
Command CharacterVariable
Target
commandcharacter
Value
?
Admin Role User ID ListVariable

List of discord user id's you like to have admin role. Comma-separated

Target
adminuserlist
Discord Client IDVariable

https://discord.com/developers/applications Select your application and go to OAuth2 in the menu. This is where you get client id and client secret. Add a redirect to your soundboardURL/login/oauth2/code/discord

Target
discordclientid
Default
replace_with_your_discord_client_id
Discord Client SecretVariable
Target
discordclientsecret
Default
replace_with_your_discord_secret
JWT SecretVariable

Set this to a unique value. You can generate one here: https://jwtgenerator.com/tools/jwt-generator

Target
jwtsecret
Default
your-secret-key-here-change-this-in-production
Moderator Role User ID ListVariable
Target
moderatoruserlist
DJ Role User ID ListVariable
Target
djuserlist
Front End URLVariable
Target
frontendurl
Default
http://localhost:8080

Download Statistics

21,705
Total Downloads
1,053
This Month
550
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
davefurrer/discordsoundboard
Last Updated2026-04-30
First Seen2022-04-04

Run DiscordSoundboard on Unraid.

DiscordSoundboard is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.