diff --git a/user-facing/media-request/seerr.md b/user-facing/media-request/seerr.md index 7c7f652..35adf79 100644 --- a/user-facing/media-request/seerr.md +++ b/user-facing/media-request/seerr.md @@ -1,44 +1,65 @@ -# Seerr — Request Movies & TV Shows +# Seerr: Request Movies & TV Shows -**Seerr** (formerly *Overseerr*) is a media request and discovery service. Browse what's available to stream, request new titles, and track what your group wants to watch next. - -## Access - -- **Web UI:** -- **Internal (home network):** - -## Features - -- Browse upcoming movies and TV shows from The Movie Database (TMDB) -- Request titles for automatic download via [Radarr](../technical/media-automation-pipeline.md#radarr) (movies) or [Sonarr](../technical/media-automation-pipeline.md#sonarr) (TV) -- Track request status: pending, processing, available, failed -- User ratings and comments on requested titles - -## Getting Started - -1. Open in your browser. -2. Click **Sign In** and choose **Sign in with The Nest**. -3. Search for a movie or TV show you'd like to watch. -4. Click **Request** — the media automation pipeline will handle the rest. - -## How Requests Work - -1. You request a title in Seerr. -2. If the title is available on TMDB, Seerr sends a command to Radarr (movies) or Sonarr (TV). -3. The appropriate service searches indexers, downloads the content, and places it in the media library. -4. Once downloaded, the status updates to **Available** and you can stream it via [Jellyfin](../media-and-entertainment/jellyfin.md). - -## Tips - -- **Search first:** Check if a title is already available before requesting — avoid duplicates. -- **Quality preferences:** You can set default quality preferences (1080p, 4K, etc.) in your Seerr profile settings. -- **TV shows:** Requesting a TV show will download all available seasons. Specify which seasons you want if needed. - -## Related Services - -- [Jellyfin](../media-and-entertainment/jellyfin.md) — Stream requested content once available -- [Sonarr & Radarr](../technical/media-automation-pipeline.md) — Automated downloaders that fulfill requests +**Seerr** (formerly *Overseerr*) is the central media discovery and request portal for **The Nest**. It allows you to browse trending movies, discover upcoming TV series, submit requests for new titles, and track what our community is watching next. --- -*TODO: Add screenshot of Seerr home page with a sample movie request.* +## 1. Getting Started & Signing In + +1. Open **[stork.mynest.love](https://stork.mynest.love)** in your Web browser. +2. Click **Sign In** and select **"Sign in with The Nest"**. +3. Log in using your standard Nest passkey. +4. Search for a movie or TV show using the search bar, or explore trending lists powered by The Movie Database (TMDB). + +--- + +## 2. How to Request Media + +Requesting new content takes just a couple of clicks! + +### Request Steps: +1. Search for the movie, TV series, or anime you want to watch. +2. Check the status badge on the title: + * If it says **Available**, it is already in our library and ready to stream on [Jellyfin](../media-and-entertainment/jellyfin.md)[cite: 9, 10]! + * If it is not in the library, click **Request**. +3. For TV series, choose whether to request all seasons or select specific seasons. +4. Select your preferred Quality Profile and click **Submit Request**. + +> [!WARNING] +> **Important Rule for Anime Requests!** +> When requesting an Anime series or movie, you **must** select the **Anime** profile from the profile dropdown instead of the default profile. Because anime formatting and episode numbering differ from Western TV releases, using the default profile will cause the automated request to fail. + +--- + +## 3. How Requests Are Processed & Timelines + +Once your request is submitted, The Nest's media pipeline processes it automatically: + +1. **Request Submission:** Seerr validates your request and sends it to our automated download system (Radarr for movies, Sonarr for TV shows). +2. **Automated Retrieval:** The backend locates high-quality releases, downloads the content, and places it into the shared media storage. +3. **Status Update:** Once complete, the request status in Seerr updates to **Available**. + +### Fulfillment Timelines: +* **Standard Requests:** Popular movies or recent TV episodes are usually downloaded within a couple of hours. +* **Jellyfin Library Indexing:** It can take up to **24 hours** for newly downloaded files to automatically index and appear in Jellyfin[cite: 9, 10]. +* **Stuck or Missing Requests?** If a title remains in *Pending* or *Processing* status for longer than 24 hours, the media may be rare or unavailable. Reach out to an administrator on Matrix to check its status[cite: 4, 10]! + +--- + +## 4. Helpful Tips + +* **Search Before Requesting:** Always search the library first to avoid submitting duplicate requests for media that is already available or currently processing. +* **Default Quality Settings:** You can configure default quality preferences (such as preferred resolution) inside your Seerr profile settings. +* **Community Features:** Explore the **Requests** tab to see what other members are looking forward to watching, or leave ratings and comments on titles. + +--- + +## 5. Service Summary & Related Links + +| Component | URL / Endpoint | Purpose | +| :--- | :--- | :--- | +| **Seerr Web UI** | [stork.mynest.love](https://stork.mynest.love) | Media discovery, title searching, and request management | + +### Related Nest Documentation: +* **[Jellyfin](../media-and-entertainment/jellyfin.md):** Stream requested movies and TV series once available[cite: 9, 10]. +* **[Media Automation Pipeline](../technical/media-automation-pipeline.md):** Technical documentation on the Sonarr and Radarr backend downloaders.