watchlist

Emby watchlist feature implementation (favorites/playlist modes and writes).

Emby does not have a first-class “account watchlist”. CrossWatch emulates one.

Related:

• Engine semantics: Watchlist (engine-level)

• Setup: Adapter: Emby

End users

What syncs

“Watchlist” is a plan-to-watch set.

In Emby it is implemented as one of:

• favorites (default)

• playlist (named playlist)

• collections (named collection)

Supported media types

• Movies: ✅

• Shows: ✅

• Seasons: usually ❌ (depends on IDs and mode)

• Episodes: ❌

Reads vs writes

• Reads: enumerate the chosen container (favorites / playlist / collection).

• Writes:

  • add adds items to that container.

  • remove removes items from that container.

Key settings

These live under the Emby provider block.

• emby.watchlist.mode: favorites | playlist | collections

• emby.watchlist.playlist_name: used when mode = playlist

• emby.watchlist.watchlist_write_delay_ms: pacing between writes

Config reference: Configuration (config.json).

Known limitations

• Missing IMDb/TMDb/TVDb IDs makes matching noisy.

• Playlist mode can churn if duplicates exist.

Troubleshooting

Watchlist adds repeat every run

• Emby item lacks external IDs.

• The destination write “sticks”, but the next read can’t match it.

Fix:

• improve metadata IDs

• add a small write delay

• keep watchlist one-way until matching is stable

Power users