Core Model
These are the objects everything else in Scryer hangs off. Read top to bottom once: each term builds on the one before it.
A facet is one of three behavior categories: movie, series, and anime. They are the Movies, Series, and Anime entries in the navigation.
The facet decides how a title behaves: metadata type, episodic handling, default monitoring, rename vocabulary, and which settings apply. Anime behaves like Series but adds filler, recap, specials, and inter-season movie handling. A facet is not a folder. Folders belong to libraries.
Catalog
Section titled “Catalog”The catalog is what you browse on a facet’s overview page: every title in that facet across the libraries your account can see. One catalog view can span several libraries.
Library
Section titled “Library”A library is a configured boundary inside a facet. It owns root folders, per-user permissions, scans, import destinations, request settings, and defaults such as quality profile and persona.
Libraries are how you model separate audiences or storage on one server: a “Kids” movie library and a “Main” movie library with different roots and different viewers still share one Movies catalog for an admin who can see both. See Library Layout.
A title is one managed media entity. A movie is a single title. Series and anime titles contain seasons, episodes, and specials.
Titles carry metadata from the metadata gateway, a library, a quality profile, monitoring state, and the local files matched to them.
Title Overview
Section titled “Title Overview”The title overview is a title’s detail page: metadata, monitoring controls, files, episodes where applicable, history, and actions such as search now. Catalog rows, calendar entries, wanted rows, and global search all lead here.
Global Search
Section titled “Global Search”Global search is the field in the header. It searches your catalog and uncataloged metadata matches in parallel. A cataloged match opens the title overview. An uncataloged match offers add, or request for users who cannot add directly.
The command palette (Cmd+K or Ctrl+K) is the other search surface. It jumps to screens and existing titles but does not add to the catalog.
Monitoring
Section titled “Monitoring”Monitoring tells Scryer to keep evaluating a title or episode. Unmonitored items stay in the catalog with their files but produce no wanted work and no upgrades.
Monitoring is set when adding a title and can be changed per title, per season, per episode, or in bulk. Series and anime also have a monitor type that decides which future episodes are monitored automatically. See Acquisition for exactly what monitoring does and does not gate.
Wanted Item
Section titled “Wanted Item”A wanted item is work Scryer has derived from catalog state: a monitored title or episode that is missing, waiting, or below its quality cutoff. Wanted items live under the Wanted navigation group in three tabs.
- Wanted Items are monitored things with no file on disk.
- Cutoff Unmet are things that have a file but not one that satisfies the quality profile’s cutoff.
- Pending are things Scryer is not ready to act on yet, usually because a delay profile is holding a release.
Search Now on any wanted row runs an interactive search without changing the title’s long-term monitoring.
Cutoff Unmet
Section titled “Cutoff Unmet”A monitored item that exists locally but does not meet the cutoff in its quality profile. It leaves the missing list and stays here until an upgrade lands or the profile changes. See Quality Profiles.
Pending
Section titled “Pending”The waiting state for wanted work. A pending item has a candidate release but a delay profile, provider backoff, or in-progress operation is holding it.
Release
Section titled “Release”A release is a candidate Scryer found on an indexer, parsed into structured fields, and scored against your policy. The outcome is grab, reject, delay, or hold as a lower-ranked alternative.
You see releases in interactive search results and in decision history. The scoring log on any result shows every contribution to its score.
Import
Section titled “Import”An import takes a completed download, matches it to a title, and moves or hard-links it into the library root, renaming as it goes. Imports also extract supported archives, fetch subtitles, refresh media servers, and run post-processing scripts.
Most imports are automatic. When a match is ambiguous, the item waits in the facet’s Import page, which appears in the navigation only while there is work to review.
History
Section titled “History”History is the audit record. Two views answer two questions:
- Activity History records operations: grabs, imports, renames, deletes, and failures. Use it when an import went wrong.
- Wanted History records decisions per title: why something was searched, grabbed, skipped, or upgraded. Use it when a title’s state changed and you want to know why.
Calendar
Section titled “Calendar”The calendar shows upcoming and recent releases for monitored titles across the libraries you can see. It is a navigation surface into title overviews, not a place where policy is set.