mirror of
https://github.com/phin05/discord-rich-presence-plex
synced 2024-11-25 02:50:17 +00:00
124 lines
5.1 KiB
Markdown
124 lines
5.1 KiB
Markdown
# Discord Rich Presence for Plex
|
|
|
|
|
|
|
|
A Python script that displays your [Plex](https://www.plex.tv/) status on [Discord](https://discord.com/) using [Rich Presence](https://discord.com/developers/docs/rich-presence/how-to).
|
|
|
|
Current Version: 2.3.1
|
|
|
|
## Getting Started
|
|
|
|
1. Install [Python 3.10](https://www.python.org/downloads/) - Make sure to tick "Add Python 3.10 to PATH" during the installation.
|
|
2. Download [this repository's contents](https://github.com/phin05/discord-rich-presence-plex/archive/refs/heads/master.zip).
|
|
3. Extract the folder contained in the above ZIP file.
|
|
4. Navigate a command-line interface (cmd.exe, PowerShell, bash, etc.) into the above-extracted directory.
|
|
5. Install the required Python modules by running `python -m pip install -U -r requirements.txt`.
|
|
6. 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.
|
|
* `writeToFile` (boolean, default: `false`) - Writes everything outputted to the console to a `console.log` file if enabled.
|
|
* `display` - Display settings for Rich Presence
|
|
* `hideTotalTime` (boolean, default: `false`) - Hides the total duration of the media if enabled.
|
|
* `useRemainingTime` (boolean, default: `false`) - Displays the media's remaining time instead of elapsed time if enabled.
|
|
* `posters`
|
|
* `enabled` (boolean, default: `false`) - Displays media posters if enabled. Requires `imgurClientID`.
|
|
* `imgurClientID` (string, default: `""`) - [Obtention Instructions](#obtaining-an-imgur-client-id)
|
|
* `buttons` (list) - [Information](#buttons)
|
|
* `label` (string) - The label to be displayed on the button.
|
|
* `url` (string) - A web address or a [dynamic URL placeholder](#dynamic-button-urls).
|
|
* `users` (list)
|
|
* `token` (string) - An access token associated with your Plex account. ([X-Plex-Token](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/), [Authenticating with Plex](https://forums.plex.tv/t/authenticating-with-plex/609370))
|
|
* `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
|
|
|
|
1. Go to Imgur's [application registration page](https://api.imgur.com/oauth2/addclient).
|
|
2. Enter any name for the application and pick OAuth2 without a callback URL as the authorisation type.
|
|
3. Submit the form to obtain your application's client ID.
|
|
|
|
### Buttons
|
|
|
|
A maximum of 2 buttons can be displayed in your Rich Presence.
|
|
|
|
Due to a strange Discord bug, buttons displayed in your Rich Presence are unresponsive to your own clicks, but other users are able to click on them to open their corresponding URLs.
|
|
|
|
#### Dynamic Button URLs
|
|
|
|
During runtime, the following dynamic URL placeholders will get replaced with real URLs based on the media being played:
|
|
* `dynamic:imdb`
|
|
* `dynamic:tmdb`
|
|
|
|
### Example
|
|
|
|
```json
|
|
{
|
|
"logging": {
|
|
"debug": true,
|
|
"writeToFile": false
|
|
},
|
|
"display": {
|
|
"hideTotalTime": false,
|
|
"useRemainingTime": false,
|
|
"posters": {
|
|
"enabled": true,
|
|
"imgurClientID": "9e9sf637S8bRp4z"
|
|
},
|
|
"buttons": [
|
|
{
|
|
"label": "IMDb Link",
|
|
"url": "dynamic:imdb"
|
|
},
|
|
{
|
|
"label": "My YouTube Channel",
|
|
"url": "https://www.youtube.com/channel/me"
|
|
}
|
|
]
|
|
},
|
|
"users": [
|
|
{
|
|
"token": "HPbrz2NhfLRjU888Rrdt",
|
|
"servers": [
|
|
{
|
|
"name": "Bob's Home Media Server"
|
|
},
|
|
{
|
|
"name": "A Friend's Server",
|
|
"listenForUser": "xyz",
|
|
"whitelistedLibraries": ["Movies"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## Configuration - Discord
|
|
|
|
The "Display current activity as a status message" setting must be enabled in Discord Settings → Activity Settings → Activity Privacy.
|
|
|
|
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
|
|
|
|
## Credits
|
|
|
|
* [Discord](https://discord.com)
|
|
* [Plex](https://www.plex.tv)
|
|
* [Python-PlexAPI](https://github.com/pkkid/python-plexapi)
|
|
* [Requests](https://github.com/psf/requests)
|
|
* [websocket-client](https://github.com/websocket-client/websocket-client)
|