Discord Rich Presence for Plex

A Python script that displays your Plex status on Discord using Rich Presence.

Current Version: 2.2.2

Getting Started

Install Python 3.10 - Make sure to tick "Add Python 3.10 to PATH" during the installation
Download this repository's contents
Extract the folder contained in the above ZIP file
Navigate a command-line interface (cmd.exe, PowerShell, bash, etc.) into the above-extracted directory
Install the required Python modules by running python -m pip install -U -r requirements.txt
Start the script by running python main.py

When the script runs for the first time, a config.json file will be created in the working directory and you will be prompted to complete the authentication flow to allow the script to retrieve an access token for your Plex account.

The script must be running on the same machine as your Discord client.

Configuration - `config.json`

Reference

logging
- debug (boolean, default: true) - Outputs additional debug-helpful information to the console if enabled.
display
- useRemainingTime (boolean, default: false) - Displays your media's remaining time instead of elapsed time in your Rich Presence if enabled.
- posters
  - enabled (boolean, default: false) - Displays media posters in Rich Presence if enabled. Requires imgurClientID.
  - imgurClientID (string, default: "") - Instructions
users (list)
- token (string) - An access token associated with your Plex account. (X-Plex-Token, Authenticating with Plex)
- servers (list)
  - name (string) - Name of the Plex Media Server you wish to connect to.
  - listenForUser (string, optional) - The script will respond to alerts originating only from this username. Defaults to the parent user's username if not set.
  - blacklistedLibraries (list, optional) - Alerts originating from libraries in this list are ignored.
  - whitelistedLibraries (list, optional) - If set, alerts originating from libraries that are not in this list are ignored.

Obtaining an Imgur client ID

Go to Imgur's application registration page
Enter any name for the application and pick OAuth2 without a callback URL as the authorisation type
Submit the form to obtain your application's client ID

Example

{
  "logging": {
    "debug": true
  },
  "display": {
    "useRemainingTime": false,
    "posters": {
      "enabled": true,
      "imgurClientID": "9e9sf637S8bRp4z"
    }
  },
  "users": [
    {
      "token": "HPbrz2NhfLRjU888Rrdt",
      "servers": [
        {
          "name": "Bob's Home Media Server"
        },
        {
          "name": "A Friend's Server",
          "listenForUser": "xyz",
          "whitelistedLibraries": ["Movies"]
        }
      ]
    }
  ]
}

License

This project is licensed under the MIT License. See the LICENSE file for details.

3.7 KiB Raw Blame History