A Discord music bot that allows users to search, queue, and control music playback directly from a voice channel
Command Prefix: !
| Command | Aliases | Description | Requirements |
|---|---|---|---|
!play |
!pl |
Plays any music that is currently added to the queue, it can also be used as a resume button if there is a song that is currently paused. Play also supports limited search functionality, searching for a song in the play command (!play The Pretender) will search for the specified song and play the first song that appears in the search (if any). |
Using the play command requires that the user is in a voice channel. |
!add |
!a !+ |
Adds the song specified in the command to the queue (!play The Pretender). |
The add command also requires that you are connected to a voice channel, and also requires that the command contains a song to add (regardless of whether said song will yield any search results or not). |
!remove |
!rm |
Removes the song that was most recently add to the queue (the sone at the back). |
The remove command requires that the user is connected to a voice channel, it also requires that the queue contains at least 1 song, remove the only song in the queue essentially just clears the queue, if the song is playing, that song will also be stopped and the bot will leave the voice channel. |
!search |
!? !se !find |
Searches for the song specified in the command and displays a list of the first 10 songs found in the search, the command also prompts you to enter your choice of which song you'd like to add to the queue. Upon choosing from one of the 10 options, the choosen song is added to the queue. |
Search requires that the user is connected to the voice channel and the command contains a song to search for (regardless of whether said song will yield any search results or not). |
!pause |
!stop |
The pause command pauses any currently playing music. |
Pause requires that the user is connected to a voice channel, and that a song is currently playing at the time of the command. |
!resume |
!re !start |
The resume command resumes any music that is currently paused. |
Resume requires that the user is connected to a voice channel, and there is a song that is currently paused. |
!join |
!j |
The join command prompts the bot to join the voice channel. |
Join requires that the user is connected to a voice channel so the bot has a channel to join. |
!leave |
!l |
The leave command prompts the bot to leave the voice channel, which will also cause any currently playing music to stop and the current music queue to be erased. |
Leave requires that the user is connected to a voice channel and that the bot is also in the voice channel. If there are no users left in the voice channel, the bot will automatically leave. |
!queue |
!q !list |
The queue command displays the first 5 songs in the queue (if any). If there are any songs playing, the first two songs are listed as playing and next, if there are no songs playing, the songs are listed in numerical order from 1 to 5. |
Queue requires that there is at least 1 song in the queue (playing or not). |
!clear |
!cl !removeall |
The clear command removes all the songs from the queue, this includes stopping and removing any song that is currently playing. |
Clear requires that there is at least 1 song in the queue. |
!previous |
!prev !pr |
The previous command skips the the previous song in the queue and immediately begins playing it, if there is not previous song in the queue (i.e. you are at the first song in the queue) previous replays the current song. |
Previous requires that you are connected to a voice channel. |
!skip |
!sk !next |
The skip command skips to the next song in the queue and immediately begins playing it (assuming there is a next song in the queue). |
The skip command requires that you are connect to a voice channel and that you are not at the end of the queue (there is a next song). |
!replay |
!rep |
The replay command replays the currently playing or paused song from the beginning, if you reach the end of the queue after playing the last song, using replay will restart the last song in the queue. |
Replay requires that you are connected to a voice channel, and that there are songs in the queue. |
git clone git@github.com:your-username-here/Study-Bot.git
cd Study-Bot
pip install -r requirements.txt