Stremio
Connect Stremio to synchronize History, Progress, Watchlist, and supported Ratings.
Media-client sync warning: Review Media clients before using a media client as a source or enabling two-way sync.
Stremio support is experimental. CW uses Stremio's internal account API. It can change without notice.
What it supports
History: read and write for movies and episodes.
Progress: read and write for movies and episodes.
Watchlist: read and write for movies and shows.
CW uses the Stremio Library as the Watchlist.
Ratings support writes from another provider to Stremio. Stremio cannot be a Ratings source.
Playlists are not supported.
Connect Stremio
Open Settings → Connections → Media clients → Stremio.
Enter your Stremio email address and password.
Select Connect Stremio.
Wait until the connection shows Stremio connected.
CW uses your credentials once to request an auth key. CW does not store your email address or password. It stores only the returned auth key.
Connection profiles
Each Stremio connection represents one Stremio account.
Stremio account profiles are not supported. Create another CW connection profile for another account.
History
Movies
Stremio stores watched state, latest watched date, and watched count.
CW synchronizes watched state and the latest available watched date.
Stremio does not expose every play event and date. CW cannot recover a complete viewing history for repeatedly watched movies.
Episodes
Stremio stores watched state for each episode. It does not store an individual watched date.
When Stremio is the source, other providers can show episodes watched on the sync date. The original dates cannot be recovered.
When CW writes dated History to Stremio, it retains watched state but discards episode dates.
Do not use Stremio as the source of truth when historical episode dates matter.
Progress
Stremio stores playback position and duration for movies and episodes.
Writing Progress requires a duration. CW can resolve a missing duration through configured metadata when possible.
Stremio keeps one active episode Progress entry per series. Writing Progress for another episode can replace the active entry.
Writing Progress does not automatically mark an item as watched.
Watchlist
CW treats the Stremio Library as the Watchlist.
Movies and shows are supported. Episodes and seasons are not Watchlist items.
Listed Library items can return as Watchlist items, including already watched titles.
Ratings
Stremio supports Ratings as a destination only. CW converts ratings from another provider into reactions.
By default:
Ratings below 6 create no reaction.
Ratings from 6 through 8 become Liked.
Ratings from 8 through 10 become Loved.
Only movies and shows are supported. Episode Ratings cannot be written.
Stremio stores reactions, not numeric ratings. A rating of 8 and 10 both become Loved. CW cannot read reactions as their original numeric rating.
Matching
Stremio relies mainly on IMDb identifiers.
CW can use configured TMDb metadata to resolve an IMDb identifier, poster, or runtime.
Items can remain unresolved when:
No IMDb identifier is available.
Stremio or Cinemeta cannot resolve the show.
The season or episode cannot be matched.
Progress has no usable position or duration.
The selected feature does not support the item type.
Recommended setup
Use a provider with complete dated History as the source of truth.
Use Stremio as a History and Ratings destination.
Start with a one-way pair and run Dry run.
Review unresolved items before enabling Remove or two-way sync.
Create a capture before importing a large History.
Common pair examples
Plex to Stremio
Movie History, episode watched state, and supported Progress synchronize to Stremio.
Stremio discards individual episode watched dates. CW writes only items mapped to Stremio identifiers.
Stremio to Plex
Movies can include their latest available watched date.
Episodes have watched state but no individual watched date. Plex can show imported episodes as watched on the sync date.
Trakt to Stremio
Movie and episode watched state synchronize to Stremio.
Separate Trakt play events become the current Stremio watched state. Individual episode dates are not retained.
Stremio to Trakt
Movie History can include the latest available movie date.
Stremio cannot preserve episode watched dates.
Provider Ratings to Stremio
Movie and show Ratings become Liked or Loved reactions.
The original numeric rating cannot be recovered from Stremio.
Disconnect Stremio
Disconnecting removes the stored Stremio auth key from CW.
It does not change existing History, Progress, Library items, or reactions in Stremio.
CW may require you to remove or update pairs that still use the connection.
Troubleshooting
Stremio rejected the credentials
Verify the email address and password by signing in to Stremio. Then reconnect.
Stremio API is unreachable
Check CW's internet connection and test again. The internal Stremio API may be temporarily unavailable.
Missing IMDb identifier
Configure TMDb Metadata and retry. Review unresolved items when no IMDb identifier exists.
Stremio episode unresolved
Confirm that the show exists in Cinemeta. Check that source season and episode numbering match Stremio.
Stremio duration missing
CW cannot calculate Progress from a percentage without a duration. Configure TMDb metadata or use a source with a runtime.
Episode watched dates changed after synchronization
Stremio does not store individual episode watched dates. CW cannot recover them later.
Unexpected Watchlist items
CW uses every listed Stremio Library item as the Watchlist. Watched items remain included.
Exact rating disappeared
Stremio stores reactions rather than numeric ratings. The source provider remains authoritative.
Authentication
CW authenticates through Stremio's internal login endpoint.
The email address and password are sent to Stremio during connection. Stremio returns an authKey, which CW stores as auth_key.
CW clears credentials after the connection attempt. It does not write them to the configuration.
CW treats the auth key as a secret. It encrypts the key when saving the configuration.
The internal API is not part of Stremio's public addon API. An API change can break the connection until CW is updated.
Configuration
The default Stremio configuration is:
Use the connection interface. Do not store a Stremio email address or password in the configuration.
Rating thresholds
Configure reaction thresholds under stremio.ratings:
liked_min sets the lowest rating that becomes Liked. loved_min sets the lowest rating that becomes Loved.
loved_min cannot be lower than liked_min. CW adjusts it when necessary.
Ratings below liked_min are skipped. Stremio Ratings remain destination-only.
Stremio data model
CW reads and updates Stremio libraryItem records.
Movie History
Movie History uses:
A movie is watched when timesWatched or flaggedWatched exceeds zero.
CW uses lastWatched as the watched date. It can use the record modification time as a fallback. Complete play history is unavailable.
Episode History
Episode History uses:
This serialized bitfield records episode watched states. It does not include per-episode timestamps.
CW does not expose record modification time as an episode watched date. The timestamp can reflect an unrelated series change.
CW maps episodes through Stremio and Cinemeta video lists. It uses the show IMDb identifier, season, and episode number.
Progress
Progress uses:
Movie records contain the active movie position. Series records contain one active episode, position, and duration.
A later write for another episode replaces those active fields. CW reads, merges, and writes the record to preserve unrelated fields.
Watchlist
CW treats the Stremio Library as the Watchlist. An item is listed when:
CW includes watched listed items. Removing a Watchlist item changes Library membership but preserves History.
Ratings
CW writes Ratings through Stremio's reactions service:
CW stores pair-scoped state for reactions it writes. This supports bookkeeping and duplicate prevention. It does not make Stremio a Ratings source.
Identifiers and metadata
IMDb is the primary Stremio identifier.
Episodes require a show IMDb identifier, season number, and episode number.
TMDb metadata can resolve a missing IMDb identifier, poster, or duration. It does not guarantee a match. Episode ordering, specials, and provider numbering can still prevent matching.
Supported item types
History: movies and episodes.
Progress: movies and episodes.
Watchlist: movies and shows.
Ratings: movies and shows, destination only.
Shows, seasons, and episodes are not interchangeable. Feature support varies by item type.
Operational behavior
CW reads the current Stremio record before writing. It merges only fields required by the chosen feature.
For example, writing Progress preserves the episode watched bitfield. Writing History preserves unrelated Library metadata.
History and Watchlist removals are supported. Stremio uses present-state semantics.
When a relevant state disappears, CW can treat it as a removal if removal synchronization is enabled.
Enable Remove only after a successful initial sync. Confirm that the Stremio Library is your intended Watchlist.
Related docs
Last updated
Was this helpful?