fabiocolacio / discord-sound-board

🎧 A sound board for discord

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SoundBoard

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

Run it yourself

Dependencies

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.

Creating and running the bot

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).

About

🎧 A sound board for discord

License:GNU General Public License v3.0


Languages

Language:Lua 100.0%