Skip to content

Build collaborative playlists with friends from discord.

Notifications You must be signed in to change notification settings

samuelrey/spot-the-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

spot-the-bot (aka Spot)

Build collaborative playlists with friends.

Installation

In this section we cover how to setup applications for message & music services, and how to configure environment variables for Spot.

Discord

Start by creating a new application for Spot in the Discord developer portal. Next install Spot to your server. Replace your client ID and navigate to the authorization URL. Select the server on which you want to install Spot.

https://discord.com/oauth2/authorize?client_id=REPLACEME&scope=bot&permissions=2048

Spot requires permission to send messages, hence 2048.

Spotify

Start by creating a new application for Spot in the Spotify developer portal. In order to authenticate, you will have to set the redirect URL to the address where you deploy Spot, eg http://example.com/callback.

Environment Variables

Spot uses environment variables to interact with message & music services.

Service Variable Description
Discord DISCORD_TOKEN Token found under the Bot section of the application.
Spotify CLIENT_ID ID found in the overview of the application.
Spotify SECRET Client secret found in the overview of the application.
Spotify REDIRECT_URL The address where you deploy Spot, eg http://example.com/callback.

Usage

In this section we cover how to run and interact with Spot.

Run

go build && ./spot-the-bot

You will then be prompted to authorize Spot to create playlists for a Spotify user. This could be your own personal account, but we recommend you create a separate account for Spot.

Commands

At this point you can interact with Spot.

Command Description
!join Jump into the queue of people that want to start a playlist.
!leave Jump out of the queue.
!list View the queue.
!next Move yourself to the back of the queue if you are at the front.
!create Make a new playlist if you are at the front of the queue. Spot will send you the link to the playlist. You will add a handful of songs (4-6) and share the playlist with the rest of the group.

Anybody can add to the playlist, not just people in the queue!

Contibuting

I'm happy to work together--feel free to reach out!

Checkout the GitHub Issues for feature and improvement ideas.

Start at the Installation section. Most steps listed there are required for local development and testing. Any additional steps are covered below.

Spotify

Add http://localhost:8080/callback to the list of redirect URLs in the developer portal and set the REDIRECT_URL environment variable accordingly.

About

Build collaborative playlists with friends from discord.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages