Correct mistakes regarding media requests
This commit is contained in:
KnightArtorias
parent
228e82cc43
commit
d3e8ce1978
5 changed files with 81 additions and 4 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
45
documentation/user-facing/media-request/shelfmark.md
Normal file
45
documentation/user-facing/media-request/shelfmark.md
Normal file
|
|
@ -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.*
|
||||
Loading…
Add table
Reference in a new issue