selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
DiscordSoundboard logo

Self-host DiscordSoundboard

v4.1.54

Discord soundboard bot with web UI and chat commands

ReleaseOpen SourceApache-2.0
Updated4 months ago
LanguageTypescript
Setup difficultyModerate
Stars
151
Port
8080 (Web UI and API)
Requires
Discord bot account, Java Runtime
Docker
davefurrer/discordsoundboard

What is DiscordSoundboard?

DiscordSoundboard is a Java-based Discord bot that lets users play sound clips in voice channels. Users trigger sounds by typing commands in Discord chat (e.g., ?soundname) or by clicking buttons in a web UI served on port 8080. The bot joins the voice channel of a configured Discord user when a sound is played. It supports role-based access control (admin, DJ, moderator, user) with optional Discord OAuth2 login for the web UI. Sounds are stored as MP3/WAV files in a configurable directory. The bot can also fetch audio from YouTube, Vimeo, and SoundCloud via chat commands. It runs as a standalone JAR (requires Java 25+ 64-bit) or via the davefurrer/discordsoundboard Docker image. Configuration is done through application.properties or environment variables. The project is open-source under Apache-2.0 and actively maintained.

Should you self-host DiscordSoundboard?

DiscordSoundboard scores 46/100 on selfhost.directory (how scoring works) and ranks #64 of 110 in Chat. It has 151 GitHub stars.

It shipped 5 stable releases in the past year. The latest, v4.1.54, came out on 4 March 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Zulip (82/100, 26 127 stars). It scores higher overall, so compare the two before you pick. See DiscordSoundboard vs Zulip side by side.

Features

  • Chat commands
  • DAVE protocol support
  • Discord OAuth2 Login
  • Entrance/Leave Sounds
  • File Upload via DM
  • Random Sound
  • Role-based Access Control
  • Volume control
  • Web UI
  • YouTube/Vimeo/SoundCloud Support

DiscordSoundboard README

How to configure DiscordSoundboard

  • adminuserlistComma-separated Discord user IDs with admin role

    Comma-separated Discord user IDs with admin role

  • bottokenDiscord bot token for authentication

    Discord bot token for authentication

  • chatcommandstrueEnable chat command processing

    Enable chat command processing

    values: true/false

  • commandcharacter?Character prefix for chat commands

    Character prefix for chat commands

  • discordclientidreplace_with_your_discord_client_idDiscord OAuth2 client ID

    Discord OAuth2 client ID

  • discordclientsecretreplace_with_your_discord_secretDiscord OAuth2 client secret

    Discord OAuth2 client secret

  • djuserlistComma-separated Discord user IDs with DJ role

    Comma-separated Discord user IDs with DJ role

  • dmtrueEnable direct message responses

    Enable direct message responses

    values: true/false

  • frontendurlhttp://localhost:8080Frontend URL for OAuth redirect

    Frontend URL for OAuth redirect

  • jwtsecretyour-secret-key-here-change-this-in-productionJWT secret for session signing

    JWT secret for session signing

  • leaveOnEmptyChanneltrueLeave voice channel when empty

    Leave voice channel when empty

    values: true/false

  • leavesuffix_leaveSuffix for leave commands

    Suffix for leave commands

  • moderatoruserlistComma-separated Discord user IDs with moderator role

    Comma-separated Discord user IDs with moderator role

  • usernameDiscord username to join voice channel (username_to_join_channel)

    Discord username to join voice channel (username_to_join_channel)

DiscordSoundboard releases & version history

More in Audio Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…