history

Emby history feature implementation (watched state indexing and writes).

Related:

• Engine semantics: History (engine-level)

• Setup: Adapter: Emby

End users

What syncs

This feature syncs watched state.

On Emby, that maps to “played” per user.

Supported media types

Commonly:

• Movies: ✅

• Episodes: ✅

Other types depend on how Emby reports IDs and user data.

Reads vs writes

• Reads: build a present-state index of what Emby considers watched.

• Writes:

  • add marks an item played.

  • remove unmarks an item played (when enabled for the pair).

Key settings

• emby.history.libraries: optional library whitelist

• emby.history.history_query_limit: limits read size

• emby.history.history_write_delay_ms: pacing between writes

Config reference: Configuration (config.json).

Library scoping: Library Whitelisting.

Known limitations

• Emby writes can take a moment to show up in reads.

• Missing external IDs makes “same item” detection harder.

Troubleshooting

History updates repeat every run

• Index matching is failing due to missing IDs.

• Or Emby is slow to reflect recent writes.

Fix:

• improve external IDs

• add a small write delay

• keep history remove disabled until stable

Power users