Skip to content

A Discord bot used to organize and host listening parties.

License

Notifications You must be signed in to change notification settings

Selbi182/ListeningPartyBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Discord – Listening Party Bot

Blahaj

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

Basic Usage

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:

  1. 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):
    /set

  2. 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:
    /set

  3. 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.
    /start

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:

last.fm 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:

Final Message

Commands

Here's a full list of every command and what it does:

/np ("now playing")

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:

/nowplaying

/set <url>

Set the target link (url: the URL to the Spotify playlist or album)

/start <countdown>

Start or resume the Listening Party (countdown: the seconds to count down, default: 5)

/quickstart <url>

A combination of /set and /start to instantly start a Listening Party without countdown (url: the URL to the Spotify playlist or album)

/stop

Cancel a current Listening Party and reset it to the beginning

/skip <amount>

Skip the current song in the Listening Party (amount: how many songs to skip, default: 1)

/previous <amount>

Play the previous song in the Listening Party (amount: how many songs to go back to, default: 1)

/restart

Restart the currently playing song

/pause

Pause the current Listening Party (resume by typing /start again)

/link

Print the set target link

/help

Print a basic tutorial of how the bot works

/commands

Print all commands as a chat message

/custom <attachment>

[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!

Support

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

About

A Discord bot used to organize and host listening parties.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages