Spotify playlist collaboration through Slack.
Control a predefined playlist via a Slash command:
/jukebox !search can be used to search for songs
/jukebox !add can be used to add songs
/jukebox !rm can be used to remove songs
/jukebox !import can be used to import songs from another playlist to the configured playlist
/jukebox !cleanup can be used to cleanup duplicates in a playlist
/jukebox !help displays help
First you'll want to create your Slack Slash Command, which you can do by going to your Slash Commands page.
During setup, have your slash command submit a POST to your app's /store
endpoint, e.g. https://app-name.herokuapp.com/store
.
Make a note of the token
, as you'll need it later to help guard against cross-site request forgery.
Head over to Spotify's Developer Site and create a new Application. Make sure you add whatever slackbox's callback URI as a valid callback URI. If you're running locally, this will be http://localhost:5000/callback
or on Heroku https://app-name.herokuapp.com/callback
Make a note of the key
, secret
and callback URI
too, as you'll need these later as well.
Also, don't forget to make a playlist. If you do this through Spotify's web interface then the playlist identifier
will be the last segment of the URI - make a note of this too! If there's a better way of finding this out, we're all ears. If you do this through the app, right-click the playlist to get it's web URL and again, you need the last segment of the URI.
Once you've cloned slackbox or hit the "Deploy with Heroku" button you'll need to setup the following environment variables. These can either be stored in a .env
or set up as config variables in Heroku.
SLACK_TOKEN
- The token from Slack's Slash Command.SPOTIFY_KEY
- Your Spotify application key (a.k.a Client ID).SPOTIFY_SECRET
- Your Spotify application secret (a.k.a Client Secret).SPOTIFY_USERNAME
- Your Spotify username.SPOTIFY_PLAYLIST_ID
- Your playlist identifier.SPOTIFY_REDIRECT_URI
- URI to redirect to once your user has allowed the application's permissions.
Visit your slackbox's home page to authenticate yourself with Spotify and you should be all set!
Forked from benchmark/slackbox.