plexinc/slack-music-notifications repository overview

⁠Before you begin

⁠1. Find the identifier of the player you want to control.

• In Plexamp, look for "user": "identifier" in config.json:

  • Mac: ~/Library/Application Support/Plexamp/config.json.
  • Windows: C:\Users\<username>\AppData\Local\Plexamp\Plexamp\config.json.

⁠2. Create a legacy slack token on this page⁠.

⁠3. Make sure you have Webhooks enabled in PMS.

• Settings → Server → Network (Show Advanced) → ☑️ Webhooks

⁠Running the app

⁠Option 1 — Deploy straight to Heroku

⁠Option 2 — Run the app locally

• Install node.js⁠ version 10 or higher, use of nvm⁠ is recommended.
• Install yarn⁠.
• Clone the repository.
• Install dependencies using yarn.
• Run the app as follows:

$ yarn start

The app is now running at http://localhost:8000⁠

⁠Option 3 - Run the app in Docker

$ yarn docker:build
$ yarn docker:start

The app is now running at http://localhost:8000⁠

⁠Configure the webhook

In your Plex account settings⁠ add a webhook pointing to where the app is running.

• If you used the Heroku deployment button the URL would look like https://<my-heroku-app>.herokuapp.com
• If you are running the app on the same computer as PMS the URL would look like http://localhost:8000

⁠Available parameters

You can provide parameters to the app either via the querystring or environment variables. If both are provided, the querystring value will take precedence.

⁠Full example

https://my-music-webhooks.herokuapp.com?token={slack_token}&username={plex_username}&player={player_client_identifier}&playEmoji={playing_emoji}&pauseEmoji={paused_emoji}