A soundboard bot for Discord using the unofficial Discord.NET API. The bot responds to mentions or direct messages and plays sound effects in a specific voice channel.
Apache License 2.0
This bot was written for a small circle of friends and suffers from a lack of documentation, no warranty of any kind, and is not representative of quality work.
- Windows
- Discord.Net
- Discord.Net.Audio
- Discord.Net.Modules
- Discord.Net.Commands
- NAudio
- Opus
- File Formats
- RIFF Wave (PCM)
- Plays sound effects with simple commands
- Resamples sound effects during playback so users don't have to ensure files have a specific sample rate, channel count, or bit-depth
- Accepts attachments in messages and downloads them for use as a sound effect
The default filename for the configuration file is soundbot.cfg
| Key | Description | Default |
|---|---|---|
| name | Bot's name used for display purposes | Discord Soundboard |
| Bot's account e-mail address | n/a | |
| password | Bot's account password | n/a |
| path.effects | Path for sound effects | Effects |
| path.database | Path for bot database file | Data/soundbot.db |
| database.save.interval | Interval (ms) the database is persisted to disk | 15000 |
| status | The 'playing game' status message to display | Soundboard |
| voice.channel | The voice channel for the bot to connect to | n/a |
| voice.bitrate | The voice bitrate to use (in bits) | 64 |
| repository.file.maximumSize | Maximum file size for sound effects (in bytes) | 2097152 |
email = [email protected]
password = example
path.effects = Effects
status = example
voice.channel = example
voice.bitrate = 128
Assuming the bot's handle is soundbot:
Lists all sound effects registered by the bot.
@soundbot list
Plays a registered sound effect. This is the default command.
@soundbot <effect>
@soundbot boop
Presents various statistics collected over time.
| stat | description |
|---|---|
| topusers | prints list of users with the longest play durations |
| topsounds | prints list of sounds with the most plays |
| totals | prints total number of sounds, number of plays, and total duration played |
@soundbot stats <stat>
@soundbot stats totals