Repository files navigation

Perplex is a Discord Rich Presence implementation for Plex.

• 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.

Perplex is built forPython 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 usingPoetry:poetry install
2. Renameconfig_example.json toconfig.json, then provide the configurable values.
3. Start Perplex:python perplex.py

Configurable Values:

• logging:severity: MinimumLoguru 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 orfalse 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 orfalse toggle for enhanced media information in Rich Presence.
• tmdb:apiKey:TMDB API key (only used iftmdbenable istrue).
• discord:appId: Discord application ID (do not modify unless necessary).
• discord:minimal:true orfalse toggle for minimal media information in Rich Presence.