Skip to content

Discord Rich Presence implementation for Plex.

License

Notifications You must be signed in to change notification settings

insomniac-afk/Perplex

 
 

Repository files navigation

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) 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 or greater. TMDB 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: 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 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 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.

About

Discord Rich Presence implementation for Plex.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.3%
  • PowerShell 0.7%