diff --git a/user-facing/media-request/shelfmark.md b/user-facing/media-request/shelfmark.md index 2643761..eb67efc 100644 --- a/user-facing/media-request/shelfmark.md +++ b/user-facing/media-request/shelfmark.md @@ -1,45 +1,57 @@ -# Shelfmark — Request Ebooks & Audiobooks +# Shelfmark: Request E-Books & Audiobooks -**Shelfmark** is a media request service for ebooks and audiobooks. Browse the catalogue, request titles, and they're automatically added to your [Calibre](../media-and-entertainment/calibre-web.md) or [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) library. - -## Access - -- **Web UI:** -- **Internal (home network):** - -## Features - -- Browse ebooks and audiobooks from multiple sources -- Request titles for automatic ingestion into Calibre or Audiobookshelf -- Track reading/listening progress across services -- Rate and review items after finishing them -- OIDC integration — sign in with your Nest account - -## Getting Started - -1. Open in your browser. -2. Click **Sign In** and choose **Sign in with The Nest**. -3. Browse the catalogue or search for a title you'd like to read or listen to. -4. Click **Request** — Shelfmark will handle adding it to your library. - -## How Requests Work - -1. You request a title in Shelfmark. -2. Shelfmark processes the request and adds the ebook or audiobook to the appropriate library (Calibre for ebooks, Audiobookshelf for audiobooks). -3. Once available, you can read or listen via [Calibre-Web](../media-and-entertainment/calibre-web.md) or [Audiobookshelf](../media-and-entertainment/audiobookshelf.md). - -## Tips - -- **Search first:** Check if a title is already in the library before requesting — avoid duplicates. -- **Formats:** Shelfmark will source the best available format (EPUB, PDF, MOBI for ebooks; M4B, OPUS for audiobooks). -- **Tracking:** Use Shelfmark to rate and review books after you finish them — stats sync across Calibre and Audiobookshelf. - -## Related Services - -- [Calibre-Web](../media-and-entertainment/calibre-web.md) — Read requested ebooks in your browser -- [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — Listen to requested audiobooks on any device -- [Seerr](seerr.md) — Request movies and TV shows (video, not books) +**Shelfmark** is the media request portal for digital books and spoken media across **The Nest**. Whether you are looking for an e-book to read on your e-reader or an audiobook to listen to on the go, Shelfmark lets you browse catalog titles and submit requests for automated library delivery. --- -*TODO: Add screenshot of Shelfmark catalogue with a sample book request.* +## 1. Getting Started & Signing In + +1. Open **[magpie.mynest.love](https://magpie.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 or browse the catalog for a title you would like to read or listen to. +5. Click **Request**—Shelfmark will process the request and add the title to your library! + +--- + +## 2. How Requests Work & Delivery Targets + +Once you submit a request, Shelfmark automatically processes the title and routes it to the appropriate platform: + +* **E-Books:** Ingested directly into your **[Calibre-Web](../media-and-entertainment/calibre-web.md)** library for web reading or e-reader syncing. +* **Audiobooks:** Ingested directly into your **[Audiobookshelf](../media-and-entertainment/audiobookshelf.md)** library for mobile listening and progress tracking. + +--- + +## 3. Search Modes & Requesting Tips + +To get the best results when searching for new media, keep these helpful tips in mind: + +* **Check Existing Libraries First:** Shelfmark does not automatically index items already stored on The Nest. Please search [Calibre-Web](../media-and-entertainment/calibre-web.md) or [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) first to ensure the title isn't already available before submitting a new request. +* **Select the Right Search Mode:** Shelfmark features three distinct search modes: + * **E-Book Mode:** Filters results specifically for readable digital books. + * **Audiobook Mode:** Filters results specifically for spoken audio recordings. + * **Universal Mode:** Searches for both e-books and audiobooks simultaneously. + +--- + +## 4. Supported Formats + +Shelfmark automatically sources the highest-quality releases available for your requested media: + +* **E-Book Formats:** Sourced primarily in **EPUB**, **PDF**, or **MOBI**. +* **Audiobook Formats:** Sourced primarily in **M4B** or high-efficiency **OPUS**. + +--- + +## 5. Service Summary & Related Links + +| Component | URL / Endpoint | Purpose | +| :--- | :--- | :--- | +| **Shelfmark Web UI** | [magpie.mynest.love](https://magpie.mynest.love) | Catalog browsing and e-book / audiobook request portal | + +### Related Nest Services: +* **[Calibre-Web](../media-and-entertainment/calibre-web.md):** Read requested e-books in your browser or sync to an e-reader. +* **[Audiobookshelf](../media-and-entertainment/audiobookshelf.md):** Stream and listen to requested audiobooks across your devices. +* **[Seerr](seerr.md):** Request movies and TV shows for video streaming. +* **[DroppedNeedle](../media-and-entertainment/droppedneedle.md):** Discover, stream, and request music releases.