Luis Garcia c3be980eea Reuse server_1_watched history to avoid duplication
Keeps the server_1_watched history that way it does not need to fetch
the same results again each time it needs to sync to another server

Signed-off-by: Luis Garcia <git@luigi311.com>
2025-07-11 17:35:53 +00:00
2025-02-21 19:37:04 -07:00
2025-05-18 20:38:19 +00:00
2025-02-19 19:48:16 -07:00
2025-02-19 19:48:16 -07:00
2025-02-19 19:48:16 -07:00
2022-07-10 01:30:12 -06:00
2025-02-21 12:10:53 -07:00
2025-07-11 16:43:55 +00:00
2025-07-11 17:01:59 +00:00
2025-07-11 16:43:55 +00:00

JellyPlex-Watched

Codacy Badge

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

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

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

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.

Description
Sync watched status between jellyfin, plex and emby locally
Readme 858 KiB
Languages
Python 84.8%
Shell 14.1%
Slim 1.1%