https://github.com/ethanc/perplex
Discord Rich Presence implementation for Plex.
https://github.com/ethanc/perplex
activity app discord episode media movie music player plex presence python rich script season server show status themoviedb tmdb tv
Last synced: about 2 months ago
JSON representation
Discord Rich Presence implementation for Plex.
- Host: GitHub
- URL: https://github.com/ethanc/perplex
- Owner: EthanC
- License: mit
- Archived: true
- Created: 2021-12-24T07:23:42.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-14T11:32:55.000Z (almost 2 years ago)
- Last Synced: 2025-03-13T17:49:32.899Z (3 months ago)
- Topics: activity, app, discord, episode, media, movie, music, player, plex, presence, python, rich, script, season, server, show, status, themoviedb, tmdb, tv
- Language: Python
- Homepage:
- Size: 36.1 KB
- Stars: 86
- Watchers: 2
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Perplex
Perplex is a Discord Rich Presence implementation for Plex.
## Features
- Modern and beautiful Rich Presence for movies, TV shows, and music.
- [The Movie Database (TMDB)](https://www.themoviedb.org/) integration for enhanced media information.
- Optional minimal mode for Rich Presence to hide granular information
- Lightweight console application that runs in the background.
- Support for two-factor authentication (2FA) at login.
- Prioritize multiple Plex media servers and users with one configuration.
## Setup
Perplex is built for [Python 3.11](https://www.python.org/) or greater. [TMDB API](https://www.themoviedb.org/settings/api) credentials are required to enable media art and external information.
Note: A Discord desktop client must be connected on the same device that Perplex is running on.
1. Install required dependencies using [Poetry](https://python-poetry.org/): `poetry install`
2. Rename `config_example.json` to `config.json`, then provide the configurable values.
3. Start Perplex: `python perplex.py`
**Configurable Values:**
- `logging`:`severity`: Minimum [Loguru](https://loguru.readthedocs.io/en/stable/api/logger.html) severity level to display in the console (do not modify unless necessary).
- `plex`:`username`: Plex username for login.
- `plex`:`password`: Plex password for login.
- `plex`:`twoFactor`: `true` or `false` toggle for two-factor authentication prompt at login.
- `plex`:`servers`: List of Plex media servers, in order of priority.
- `plex`:`users`: List of Plex users, in order of priority.
- `tmdb`:`enable`: `true` or `false` toggle for enhanced media information in Rich Presence.
- `tmdb`:`apiKey`: [TMDB API](https://www.themoviedb.org/settings/api) key (only used if `tmdb` `enable` is `true`).
- `discord`:`appId`: Discord application ID (do not modify unless necessary).
- `discord`:`minimal`: `true` or `false` toggle for minimal media information in Rich Presence.