PlexRecs
A Discord bot that provides movie and TV show recommendations from your Plex library
DISCLAIMER: This bot requires a Discord account and server, a Plex Media Server and Tautulli/PlexPy (Plex monitoring) software to function. Requires Python 3.6+
Setup
- Make a Discord Bot (HOW TO MAKE A DISCORD BOT: https://discordpy.readthedocs.io/en/rewrite/discord.html). Bot will need read/write text channel permissions, including links, attachments and emojis, and message management.
- Clone this repo with
git clone https://github.com/nwithan8/PlexRecs.git
- Navigate to PlexRecs directory with
cd PlexRecs
- Install dependencies with
pip3 install -r requirements.txt
- Open
credentials.py
file and fill out the credentials - Run the bot with
python3 run.py
Usage
Once the bot is up and running, trigger it by typing "[PREFIX] recommend [CATEGORY]" to get a randomly selected movie/show/artist recommendation.
To only get recommended something you have not already watched/listened to, type "[PREFIX] recommend [CATEGORY] new [Your Plex Username]".
Features
In addition to a recommendation, the owner of the Plex Server (whoever has the OWNER_DISCORD_ID) will be offered up to five available players that they can have the recommendation automatically play on.
Due to security limitations in the Plex API, this option is only available for the user currently logged into Plex (in this case, the Plex server administrator).
Contact
Please leave a pull request if you would like to contribute.
Follow me on Twitter: @nwithan8
Also feel free to check out my other projects here on GitHub or join the #developer channel in my Discord server below.