This software no longer works due to breaking changes in the Discordia API
SoundBoard is a bot for discord which is capable of playing sounds in the voice channels of a discord server.
Once SoundBoard is setup, you simply need to create a folder in your computer filled with sound files, and users will be able to command the bot to play them in the voice channels
Note: I do not have any windows machines, and thus this software has not been tested on windows platforms. The code should work on them, but if any bugs or compatibility issues arise (on any platform), please submit an issue or even a pull request with a fix.
You will need to install the Luvit Lua distribution at luvit.io.
Next, you will need to install the
Discordia library. Discordia
can be easily installed with the lit
command includeded with Luvit.
Simply open a terminal and type lit install SinisterRectus/discordia
Finally, you will need libopus
, libsodium
, and ffmpeg
installed.
If you are using linux, these are in the package managers of most distros.
First, you must register your bot with discord here. Make sure to set the app as a bot user.
Next, add the bot to a server with this link:
https://discordapp.com/api/oauth2/authorize?client_id=your_id_here&scope=bot&permissions=0
You will need to replace your_id_here
in the link, with your bot's client_id.
Next edit config.example.lua
, and replace the following strings with your own info:
opus_path => the path to the opus library
sodium_path => the path to the sodium library
bot_token => your bot's discord token
sounds_location => the path to the folder containing all the sounds for the bot
command_prefix => the prefix to every command to differentiate from commonds for other bots
Save the config file as simply config.lua
.
You can finally run the bot by running the lua file with luvit discord_sound_board.lua
.
Once the Bot is logged into the server, you can check commands and usage with !help
, (the !
prefix is configurable in config.lua
).