A Spotify-powered Discord bot for hosting listening parties!
Use the following URL to invite the bot to your server:
https://discord.com/oauth2/authorize?client_id=1062043789646118982&permissions=18432&scope=bot
(Make sure the permissions for sending messages and embedding links are checked, otherwise the bot won't work.)
Once the bot is invited to your server, make sure it has writing permissions. Once that's done, you can manage listening parties on a per-channel basis (threads aren't supported yet). Here is how you do that:
-
Type
/set
and pass a URL to a Spotify album or playlist (you can get the link by right-clicking on the playlist or album and selecting Share → Copy Album/Playlist Link):
-
The bot will then verify and preprocess the given target. If everything looks good, a message with the link will pop up, so that everyone can get ready:
-
Type
/start
to start the actual listening party. A custom countdown (in seconds) can be passed to this command. By default, it's 5 seconds.
And that's all there is to it! From here on out, the bot will provide detailed information about whichever song is currently playing in a synchronized manner. When possible, it will also display some additional information of the current song from last.fm's wiki:
This continues until every song of the given playlist or album has been played. At the end, you'll get a random final message:
Here's a full list of every command and what it does:
Print info of the currently ongoing Listening Party for this channel. Useful for late joiners, because it also displays the timestamp of the current song:
Set the target link (url: the URL to the Spotify playlist or album)
Start or resume the Listening Party (countdown: the seconds to count down, default: 5)
A combination of /set
and /start
to instantly start a Listening Party without countdown (url: the URL to the Spotify playlist or album)
Cancel a current Listening Party and reset it to the beginning
Skip the current song in the Listening Party (amount: how many songs to skip, default: 1)
Play the previous song in the Listening Party (amount: how many songs to go back to, default: 1)
Restart the currently playing song
Pause the current Listening Party (resume by typing /start
again)
Print the set target link
Print a basic tutorial of how the bot works
Print all commands as a chat message
[Experimental] Host a party custom-defined by the given attachment. This feature is highly experimental and therefore shouldn't be used unless you know what you're doing!
If you got any problems, write an issue ticket on GitHub and I will gladly take a look at it :)
Alternatively, message me on Discord: Selbi#7270