# Watchable

Watchable is a self-hosted automation app. Syncs watch state (played, unplayed, and in-progress position) between Plex, Jellyfin, and Emby through a local SQLite database, with no direct server-to-server syncing. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3467/watchable

## Description

Syncs watch state (played, unplayed, and in-progress position) between Plex, Jellyfin, and Emby through a local SQLite database, with no direct server-to-server syncing. Configured entirely from one YAML file: servers, per-person account mapping, and sync pairs that can be one-way or bidirectional with configurable conflict resolution. Also takes scheduled database backups with automatic retention. Beta: actively developed, and the config format and behaviour may still change between releases. Full setup docs are in the GitHub repository.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

51/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 12 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/watchable-0c4bdkj010gcn3?q=Watchable
- GitHub: https://github.com/Poag/watchable

## Common questions

### Does Watchable sync media servers directly to each other?

No. Each run pulls current watch state from the configured servers into a local SQLite database, reconciles it there, and then pushes out only the changed state.

### How does Watchable match the same movie or episode across Plex, Jellyfin, and Emby?

It matches items using external IDs such as IMDb, TMDb, or TVDb, since each server may assign different internal IDs to the same item.

### How can I check a config or preview a sync before it happens?

Use watchable validate to check the YAML, watchable test-connections to verify servers are reachable, and watchable sync --dry-run to see what a sync would do.

### How should Watchable be run continuously?

The simplest option is a cron job or systemd timer calling watchable sync. A Docker image can also run watchable as a long-lived process by setting sync.schedule.interval_minutes.

### How are database backups handled?

Use watchable backup create, list, restore, and purge for manual snapshots. With watchable run, set backup.interval_hours for scheduled backups and backup.keep_days for automatic old-backup purge.

### What happens when two servers both have different watch states?

For one-way pairs, one server always overwrites the other. For bidirectional pairs, you can choose most-progressed-wins, most-recently-played-wins, or a fixed side always wins.

---
Source: Our Local Host (https://ourlocalhost.com/app/3467/watchable), the self-hosted and open-source app directory.
