
Rules, guidelines, and how things work
Key Concept
In Medialib, you don't rate a movie—you rate a viewing of that movie. Rewatches are a first-class feature, not an afterthought.
Traditional rating systems force users into philosophical dilemmas that have no good answers:
I read this when I was 14 and it was a 10/10. Then I re-read it at 24 and it's a 6/10. What's my rating now? Should it be a 10? A 6? An average of 8? Should I rate it 'for kids'?
When I first saw this crazy twist it was a 9/10 movie. But on a rewatch when I knew what was coming, it completely fell apart...
Viewings eliminate these questions entirely. Instead of wrestling with abstract concepts, you simply record what actually happened.
Each time you watch something, you create a viewing. Add rewatches by clicking the + button to create another viewing for the same title.
This approach mirrors reality: you watched Dune Part One in the cinema when it released in 2021, then again at home in 2024. These were genuinely different experiences—different dates, different contexts, potentially different ratings.
With sufficient viewing data, Medialib can identify patterns and insights that single-rating systems miss entirely. Movies can be flagged as "great on rewatch" or "doesn't hold up," providing valuable context for future viewers.
To track multiple watches, reads, or playthroughs, you can add multiple viewings. This guide will refer to all media consumption as "viewings" and focuses on show-level behavior (ignoring season-level viewings).
TL;DR
If you want to start a rewatch and use automated scrobbling, create a new viewing first through the app.
New episode viewings, whether created through scrobbling or manually, are always added to your active viewing. Your active viewing is your most recently created show-level viewing. (Manual active viewing selection may be added later)
Medialib automatically creates your first show-level viewing when you start tracking a new TV show.
Medialib will not automatically create additional show-level viewings unless it's absolutely certain you're starting a rewatch.
Consider a completed show like Rome, which has 2 seasons with 22 episodes overall.
Automatic rewatch detection only triggers when your current show-level viewing contains every aired episode watched exactly once, and then you watch the first episode (S01E01) again. Only then will Medialib create a new show-level viewing automatically.
In all other scenarios, new episode viewings are added to your existing active show-level viewing.
Viewing patterns for TV shows are incredibly diverse, making it nearly impossible to accurately predict user intent for rewatches.
Anything that automatically changes your watch status or adds new viewings is just very intrusive. Especially if its "wrong" and you cant stop it. That's why Medialib airs on the side of caution.
If you want to start a new viewing before completing all episodes, you must manually create a new show-level viewing through the app. Once created, all subsequently scrobbled episodes will be added to this new viewing.
Important
These rules apply to both automated scrobbling (Stremio, Plex, etc.) and manual episode tracking through the app.