From d3e8ce1978749dcaf0034f3e644eb1c137e70698 Mon Sep 17 00:00:00 2001 From: KnightArtorias Date: Fri, 24 Jul 2026 08:13:10 -0400 Subject: [PATCH] Correct mistakes regarding media requests --- documentation/README.md | 5 ++- .../media-and-entertainment/audiobookshelf.md | 12 ++++- .../media-and-entertainment/calibre-web.md | 8 +++- .../media-and-entertainment/droppedneedle.md | 15 +++++++ .../user-facing/media-request/shelfmark.md | 45 +++++++++++++++++++ 5 files changed, 81 insertions(+), 4 deletions(-) create mode 100644 documentation/user-facing/media-request/shelfmark.md diff --git a/documentation/README.md b/documentation/README.md index 32b7d0a..c50f232 100644 --- a/documentation/README.md +++ b/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 diff --git a/documentation/user-facing/media-and-entertainment/audiobookshelf.md b/documentation/user-facing/media-and-entertainment/audiobookshelf.md index 3dcfa1d..ee61d2d 100644 --- a/documentation/user-facing/media-and-entertainment/audiobookshelf.md +++ b/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 --- diff --git a/documentation/user-facing/media-and-entertainment/calibre-web.md b/documentation/user-facing/media-and-entertainment/calibre-web.md index e6985b4..73b8116 100644 --- a/documentation/user-facing/media-and-entertainment/calibre-web.md +++ b/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 --- diff --git a/documentation/user-facing/media-and-entertainment/droppedneedle.md b/documentation/user-facing/media-and-entertainment/droppedneedle.md index d5df940..4bd5adb 100644 --- a/documentation/user-facing/media-and-entertainment/droppedneedle.md +++ b/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: diff --git a/documentation/user-facing/media-request/shelfmark.md b/documentation/user-facing/media-request/shelfmark.md new file mode 100644 index 0000000..2643761 --- /dev/null +++ b/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:** +- **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) + +--- + +*TODO: Add screenshot of Shelfmark catalogue with a sample book request.*