Sync watched status between jellyfin, plex and emby locally

Go to file

Luis Garcia 64c1823e5b tag 7.0.3 Signed-off-by: Luis Garcia <git@luigi311.com>		2025-04-03 19:25:20 +00:00
.github	Swap to UV	2025-02-19 19:48:16 -07:00
.vscode	vscode: Fix deprecated python debug type	2025-02-21 14:47:14 -07:00
src	Jellyfin/Emby: Add fallback to media files for library types	2025-04-02 04:27:39 +00:00
test	CI: Better validate logging	2025-02-21 19:37:04 -07:00
.dockerignore	Do not include test in docker image	2025-02-21 19:52:12 -07:00
.env.sample	Reduce sample max_threads to 2	2024-11-09 12:53:13 -07:00
.gitignore	Swap to UV	2025-02-19 19:48:16 -07:00
.python-version	Swap to UV	2025-02-19 19:48:16 -07:00
Dockerfile.alpine	Docker: Set default env values to prevent issues	2025-02-21 23:36:19 -07:00
Dockerfile.slim	Docker: Set default env values to prevent issues	2025-02-21 23:36:19 -07:00
LICENSE	Use async for jellyfin (#23 )	2022-07-10 01:30:12 -06:00
README.md	Update README.md to uv; make environment setting more clear	2025-02-25 23:44:26 -06:00
docker-compose.yml	Docker Compose: Use env_file for most variables	2024-08-28 16:46:19 -06:00
entrypoint.sh	Swap to UV	2025-02-19 19:48:16 -07:00
main.py	Force python 3.12 or greater	2025-02-21 12:10:53 -07:00
pyproject.toml	tag 7.0.3	2025-04-03 19:25:20 +00:00
uv.lock	tag 7.0.3	2025-04-03 19:25:20 +00:00

README.md

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
```

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.)
Run
```
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.