Skip to content

Latest commit

 

History

History
65 lines (40 loc) · 2 KB

README.md

File metadata and controls

65 lines (40 loc) · 2 KB

Mopidy-Slack

Mopidy extension for controlling music from Slack.

Requires you to create a slack app in your workspace.

Installation

Install by running: pip install Mopidy-Slack

Configuration

Slack App

To work you need to create a Slack App and install it to your workspace. This way you get the bot user OAuth access token, useful later

Then you need to activate the events API. This API requires the URL on which your mopidy instance is callable. If you are testing it on local you can use ngork to expose your instance on the web. After you domain, add the endpoint /slack/events.

You also need to subcribe the app to the event message.channels. This way the app will receive all messages posted in channel where its had been added. Beware not to post confidential data ⚠️

Mopidy

In mopidy configuration, you must add your Slack app's Bot User OAuth Access Token using bot_token

So configuration is:

[slack]
bot_token=xoxb-123456789123-1234567891234-xxx

Extension commands

All available commands are available in the folder command. Currently there is :

  • help Display the help
  • keep Ask to keep the current playing song
  • next Ask to skip the current playing song
  • request song_name [- artist_name] Request a new song to be played
  • start [playlist_name] Start the radio broadcast. The bot will look for playlist starting with given name of fallback to the default playlist

Note that there is no / before the command, this way we are not using the slack app commands. If we used this mecanism, the configuration of app would be long and difficult to maintain.

Project resources

More gifs

Changelog

v0.1.0 (2020-05-13)

  • Initial release.