Correct mistakes regarding media requests

documentation/README.md

@@ -13,9 +13,12 @@ These guides explain what each service does, how to reach it, and how to get sta
   - [Audiobookshelf](user-facing/media-and-entertainment/audiobookshelf.md) — Audiobooks and podcasts
   - [DroppedNeedle](user-facing/media-and-entertainment/droppedneedle.md) — Music discovery and streaming
   - [Calibre-Web](user-facing/media-and-entertainment/calibre-web.md) — E-book library
+- **Media Request**
+  - [Seerr](user-facing/media-request/seerr.md) — Request movies, TV shows, and anime for Jellyfin
+  - [Shelfmark](user-facing/media-request/shelfmark.md) — Request ebooks and audiobooks for Calibre and Audiobookshelf
+  - [DroppedNeedle](user-facing/media-and-entertainment/droppedneedle.md) — Discover and request music from Usenet, Soulseek, and your local library
 - **Productivity & Creation**
   - [Forgejo](user-facing/productivity-and-creation/forgejo.md) — Git hosting and code collaboration
-  - [Shelfmark](user-facing/productivity-and-creation/shelfmark.md) — Track what you read and listen to
   - [Foundry VTT](user-facing/productivity-and-creation/foundry-vtt.md) — Virtual tabletop for TTRPGs
 - **Storage & Files**
   - [Nextcloud](user-facing/storage-and-files/nextcloud.md) — File sync, sharing, and cloud storage

documentation/user-facing/media-and-entertainment/audiobookshelf.md

@@ -35,7 +35,17 @@
 
 ## Where Does the Content Come From?
 
-Audiobooks and podcasts are stored on an NFS share (`robin.home.nest:/yarr/media/audiobooks`). New content is added by the admin. If you have personal audiobook files you'd like to add, ask an admin about mounting your own directory.
+Audiobooks and podcasts are stored on an NFS share (`robin.home.nest:/yarr/media/audiobooks`). New content is added by:
+
+- **[Shelfmark](../media-request/shelfmark.md)** — Users can request audiobooks directly through Shelfmark, which automatically populates the Audiobookshelf library.
+- **Admin upload** — The admin may add audiobooks manually to the NFS share.
+
+If you have personal audiobook files you'd like to add, ask an admin about mounting your own directory.
+
+## Related Services
+
+- [Shelfmark](../media-request/shelfmark.md) — Request audiobooks (populated into Audiobookshelf library)
+- [Calibre-Web](../media-and-entertainment/calibre-web.md) — For e-books instead of audiobooks
 
 ---
 

documentation/user-facing/media-and-entertainment/calibre-web.md

@@ -37,11 +37,15 @@
 
 ## Where Does the Content Come From?
 
-E-books are stored on an NFS share (`robin.home.nest:/yarr/media/books/calibre-library`). New books are added by the admin or via the Calibre-Web upload interface (if enabled). The `calibre-ingest` directory is monitored for new files.
+E-books are stored on an NFS share (`robin.home.nest:/yarr/media/books/calibre-library`). New books are added by:
+
+- **[Shelfmark](../media-request/shelfmark.md)** — Users can request ebooks directly through Shelfmark, which automatically populates the Calibre library.
+- **Admin upload** — The admin may add books manually via the `calibre-ingest` directory (monitored for new files).
+- **Calibre-Web upload** — If enabled by admin, you can upload books directly through the web UI.
 
 ## Related Services
 
-- [Shelfmark](../productivity-and-creation/shelfmark.md) — Track what you've read and rate books
+- [Shelfmark](../media-request/shelfmark.md) — Request ebooks and audiobooks (populated into Calibre library)
 - [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — For audiobooks instead of e-books
 
 ---

documentation/user-facing/media-and-entertainment/droppedneedle.md

@@ -22,6 +22,21 @@
 3. Use the search bar to find a song, album, or artist.
 4. Click play — DroppedNeedle will locate and stream the best available source.
 
+## How Music Requests Work
+
+DroppedNeedle lets you discover and request music yourself — no admin intervention needed. Here's how it works:
+
+1. **Search** for a song, album, or artist using the search bar.
+2. DroppedNeedle queries multiple sources simultaneously:
+   - **Usenet indexers** for high-quality releases
+   - **[slskd](../technical/slskd-soulseek.md)** for Soulseek peer shares
+   - **Local library** for music already stored on The Nest
+3. Browse the results and click **Play** to stream immediately, or **Download** to add it to your library.
+4. If a source isn't available, DroppedNeedle can queue a request — the media automation pipeline will handle downloading it when possible.
+
+> [!TIP]
+> Music requests are handled by you directly through DroppedNeedle's interface. Just search and play!
+
 ## How It Finds Music
 
 DroppedNeedle queries multiple backends:

documentation/user-facing/media-request/shelfmark.md

@@ -0,0 +1,45 @@
+# Shelfmark — Request Ebooks & 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:** <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.*