The-Nest/docs
The-Nest/docs
1
0
Fork 0
Code Issues 2 Pull requests 1 Projects Releases Packages 1 Wiki Activity Actions

Shelfmark pass

Browse source
This commit is contained in:
Astra Logical 2026-07-26 17:00:30 -04:00
parent 7c8b096d2c
commit fbb3a9334a
1 changed files with 53 additions and 41 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

94
user-facing/media-request/shelfmark.md
View file

@ -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. **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.
## Access
- **Web UI:** <https://magpie.mynest.love>
- **Internal (home network):** <http://shelfmark.k3s.home.nest>
## 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 <https://magpie.mynest.love> 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)
--- ---
*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.