JellyPlex-Watched

Sync watched between jellyfin, plex and emby locally

Description

Keep in sync all your users watched history between jellyfin, plex and emby servers locally. This uses file names and provider ids to find the correct episode/movie between the two. This is not perfect but it works for most cases. You can use this for as many servers as you want by entering multiple options in the .env plex/jellyfin section separated by commas.

Features

Plex

• [x] Match via filenames
• [x] Match via provider ids
• [x] Map usernames
• [x] Use single login
• [x] One way/multi way sync
• [x] Sync watched
• [x] Sync in progress
• [ ] Sync view dates

Jellyfin

• [x] Match via filenames
• [x] Match via provider ids
• [x] Map usernames
• [x] Use single login
• [x] One way/multi way sync
• [x] Sync watched
• [x] Sync in progress
• [x] Sync view dates

Emby

• [x] Match via filenames
• [x] Match via provider ids
• [x] Map usernames
• [x] Use single login
• [x] One way/multi way sync
• [x] Sync watched
• [x] Sync in progress
• [x] Sync view dates

Configuration

Full list of configuration options can be found in the .env.sample

Installation

Baremetal

• Install uv

• Create a .env file similar to .env.sample; fill in baseurls and tokens, remember to uncomment anything you wish to use (e.g., user mapping, library mapping, black/whitelist, etc.). If you want to store your .env file anywhere else or under a different name you can use ENV_FILE variable to specify the location.

• Run

  uv run main.py
  

  ENV_FILE="Test.env" uv run main.py
  

Docker

• Build docker image

  docker build -t jellyplex-watched .
  

• or use pre-built image

  docker pull luigi311/jellyplex-watched:latest
  

With variables

• Run

  docker run --rm -it -e PLEX_TOKEN='SuperSecretToken' luigi311/jellyplex-watched:latest
  

With .env

• Create a .env file similar to .env.sample and set the variables to match your setup

• Run

   docker run --rm -it -v "$(pwd)/.env:/app/.env" luigi311/jellyplex-watched:latest
  

Troubleshooting/Issues

• Jellyfin

  • Attempt to decode JSON with unexpected mimetype, make sure you enable remote access or add your docker subnet to lan networks in jellyfin settings

• Configuration

  • Do not use quotes around variables in docker compose
  • If you are not running all 3 supported servers, that is, Plex, Jellyfin, and Emby simultaneously, make sure to comment out the server url and token of the server you aren't using.

Contributing

I am open to receiving pull requests. If you are submitting a pull request, please make sure run it locally for a day or two to make sure it is working as expected and stable.

License

This is currently under the GNU General Public License v3.0.