Repository files navigation

Get personalized movie and TV show recommendations based on your Plex libraries and ratings. The more you rate, the better it learns your preferences!

• Shows you movies and TV shows you might like based on your ratings
• Learns your preferences over time
• Adds recommendations to your Plex watchlist
• Creates and manages Plex collections
• Works with your existing Plex libraries

The app runs completely independently of your Plex server. It only interacts with Plex to:

• Read your library contents during initial scan
• Add items to your watchlist when requested
• Create/modify collections when requested
• Fetch poster images for display
• Sync watch history (if enabled) to give improved recommendations
• Sync Plex server side ratings (if enabled) to give improved recommendations

All recommendation logic, learning, and data storage happens locally in the app. Your Plex server is never modified without explicit actions from you.

• Rate movies and shows from 1-10
• Skip things you're not interested in
• Block items you never want to see
• Go back to previous recommendations
• Can import your watch history and Plex side ratings to improve it's learning.
• Gets better the more you use it

• Works directly with your Plex server
• Adds items to your Plex watchlist
• Creates collections in Plex
• Auto-adds highly rated movies to collections
• Can import your watch history and Plex side ratings to improve it's learning.

1. A Plex server
2. Free API keys from:
   • TMDB
   • TVDB
3. YourPlex token

1. Download the latest Windows release
2. Run the executable
3. Enter your Plex and API information
4. Select which libraries to use
5. Start rating content!

1. Download the latest source release.

# Install dependenciesbrew install python@3.11brew install sqlite3# Clone repositorygit clone https://github.com/gorgarp/recommender.gitcd recommender# Create virtual environmentpython3 -m venv venvsource venv/bin/activate# Install requirementspip install -r requirements.txt# Run the applicationpython main.py

1. Install dependencies:

# Ubuntu/Debiansudo apt-get updatesudo apt-get install python3.11 python3-pip python3-venv sqlite3 python3-pyqt6# Fedorasudo dnf install python3.11 python3-pip python3-virtualenv sqlite python3-pyqt6# Clone repositorygit clone https://github.com/gorgarp/recommender.gitcd recommender# Create virtual environmentpython3 -m venv venvsource venv/bin/activate# Install requirementspip install -r requirements.txt# Run the applicationpython main.py

1. In the Configuration tab:
   • Enter your Plex URL (e.g.,http://localhost:32400)
   • Add your Plex token
   • Add your TVDB and TMDB API keys (Use the read only token for TMDB)
2. Click "Save Configuration"
3. Click "Load Libraries" to see your Plex libraries
4. Select which libraries to include
5. Optional: Set up collection preferences
   • Choose a collection name
   • Set rating threshold for auto-adding
6. Click "Scan Libraries" to begin

• Open the Movies or TV Shows tab
• Rate items from 1-10
• Skip items you don't want to rate
• Block items you never want to see
• Use the Back button to return to previous items

• Movies can be added to collections automatically or manually
• Set a minimum rating to auto-add movies to collections
• Configure your preferred collection name
• Collections appear directly in your Plex library

• Add any item to your Plex watchlist
• Clear your entire watchlist from the Configuration tab
• Items sync with your Plex server

In short, you have the option to import your prior watch history and Plex side ratings. This allows the program to create better recommendations.

1. Can't connect to Plex?

   • Check your Plex URL
   • Verify your token
   • Make sure Plex is running

2. Recommendations not improving?

   • Rate more items
   • Try using the full rating scale
   • Check if library scan completed

3. Features not working?

   • Verify API keys
   • Check error messages in Configuration tab
   • Try rescanning libraries

This project is under the GPLv3 License - seeLICENSE file.