A discord bot to control and view your MPD server, as well as stream output through voice.
Install the requirements in requirements.txt
.
All features require an MPD server.
For some features, you will need to configure a web server (or two) with a directory containing your music library, and another where album art will be placed.
Change the settings in settings.json
to match your setup and requirements.
Launch the bot from main.py
.
The token for the Discord bot account you wish to run it through.
The command prefix i.e what a message must start with for the bot to interpret it as a command.
The MPD server host address.
The MPD server port number.
The server connection timeout. In most cases you won't need to ever touch this. In some rare circumstances, increasing this may help connection issues.
The full path to MPD's FIFO file. This is required to stream audio through discord. You must configure MPD itself to output to a FIFO file.
The location in which album art should be saved to. If you want this to actually do anything, this should be a web server directory since Discord can only fetch images via HTTP(S).
The location of your music library. Used to search for album art in album directories.
The URL to where album art can be fetched from. Used to display album art along-side songs in embeds.
The URL to where music files can be fetched from. Used for the download button in song embeds.
To add new commands or configure existing commands to the bot, all you have to do
is add an entry to settings.json
.
The parent key is the name of the command. This is both used
in order to use the command from Discord, and internally -
a function of the same name must exist in commands.py
.
The aliases are a list of alternate words which can be used in order to run the command.
The description is displayed when the help
command is used.