What's New
Watch-Aware Library
Luminarr now knows what you've watched. Connect your Plex, Jellyfin, or Emby server and Luminarr will sync your watch history — closing the loop between "I downloaded this" and "I actually watched it."
Watch history sync:
- Plex, Jellyfin, and Emby plugins now implement
WatchProvider - Automatic sync every 6 hours (or trigger manually from System page)
- Deduplication — same watch event is never recorded twice
- TMDB ID matching reuses existing Plex GUID parser (both new and legacy agent formats)
What you can see:
- Dashboard: "WATCHED" badge on poster cards for movies you've seen
- Movie detail: watch info card showing play count and last watched date ("Watched 3 times · Last: Mar 15, 2026")
- Stats:
GET /api/v1/stats/watchreturns total watched, unwatched, and percentage
Privacy: all watch data stays local. Luminarr queries your media server directly — no data leaves your network.
API
| Endpoint | Method | Description |
|---|---|---|
POST /api/v1/watch-sync/run
| POST | Trigger manual watch history sync |
GET /api/v1/stats/watch
| GET | Aggregate watch statistics |
GET /api/v1/movies/{id}
| GET | Now includes watch_status object
|
Technical
- New
WatchProviderinterface inpkg/plugin/watch.go - Migration 00033:
watch_history+watch_sync_statetables - Watch sync service with per-server last-sync tracking
- Scheduled job running every 6 hours