Sync watched status between jellyfin, plex and emby locally

Go to file

Luigi311 4771f736b0 Merge pull request #223 from luigi311/update Update python and PlexAPI		2025-02-18 17:23:47 -07:00
.github	Update to Python 3.13	2025-02-18 16:43:22 -07:00
.vscode	Handle episode names are not unique	2024-01-05 14:58:24 -07:00
src	Dont show error on extract show/episode/movies output dict	2024-11-09 13:38:59 -07:00
test	CI: Update plex token	2025-02-18 17:10:54 -07:00
.dockerignore	Update Dockerfile to use the alpine Python 3 base image	2023-04-13 02:26:04 +02:00
.env.sample	Reduce sample max_threads to 2	2024-11-09 12:53:13 -07:00
.gitignore	Gitignore: expand .env	2024-04-14 17:06:29 -06:00
Dockerfile.alpine	Update to Python 3.13	2025-02-18 16:43:22 -07:00
Dockerfile.slim	Update to Python 3.13	2025-02-18 16:43:22 -07:00
LICENSE	Use async for jellyfin (#23 )	2022-07-10 01:30:12 -06:00
README.md	README: Remove dev information	2024-07-15 04:36:27 -06:00
docker-compose.yml	Docker Compose: Use env_file for most variables	2024-08-28 16:46:19 -06:00
entrypoint.sh	Entrypoint: Alpine fix overlapping PGID issue	2024-09-13 16:24:58 -06:00
main.py	Bump minimum Python version to 3.9	2024-01-05 14:58:24 -07:00
requirements.txt	Requirements: Update PlexAPI 4.16.1	2025-02-18 16:42:35 -07: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

Setup virtualenv of your choice
Install dependencies
```
  pip install -r requirements.txt
```
Create a .env file similar to .env.sample, uncomment whitelist and blacklist if needed, fill in baseurls and tokens
Run
```
python 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

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.