WatchState

WatchState is a self-hosted tool that keeps users’ watch progress and play state synchronized across Plex, Jellyfin, and Emby media servers. It supports one-way or many-to-many sync without relying on external third-party services.

Key Features

• Multi-user and sub-user support
• One-way or two-way (many-to-many) play-state synchronization between backends
• Webhook ingestion from supported media servers to update state in near real time
• Scheduled and on-demand imports to reconcile missed events
• Portable play-state backup/export
• Detection of unmatched/mismatched items across servers
• Metadata search and parity checks to compare backend reporting
• Checks for stale references to old or removed files

Use Cases

• Keep watch progress consistent between a local Jellyfin server and a remote Plex server
• Migrate or rebuild a media server while preserving watch history via backups/restore
• Audit libraries across multiple backends to find mismatches and stale references

WatchState is well-suited for homelab and multi-server media setups where consistency and data ownership are important, offering both automation (webhooks/scheduling) and manual control for synchronization and verification.