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: 3 days ago
JSON representation

Discord Rich Presence implementation for Plex.

• Host: GitHub
• URL: https://github.com/ethanc/perplex
• Owner: EthanC
• License: mit
• Created: 2021-12-24T07:23:42.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-07-04T07:42:40.000Z (over 1 year ago)
• Last Synced: 2023-07-04T09:06:50.875Z (over 1 year 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: 64
• Watchers: 2
• Forks: 7
• Open Issues: 1
• 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.