diff --git a/user-facing/media-and-entertainment/audiobookshelf.md b/user-facing/media-and-entertainment/audiobookshelf.md index ea2c7c4..f4fd71e 100644 --- a/user-facing/media-and-entertainment/audiobookshelf.md +++ b/user-facing/media-and-entertainment/audiobookshelf.md @@ -1,48 +1,62 @@ -# Audiobookshelf — Audiobooks & Podcasts +# Audiobookshelf: Audiobooks & Podcasts -**Audiobookshelf** is a self-hosted audiobook and podcast server. It organizes your collection, tracks listening progress across devices, and supports background playback. - -## Access - -- **Web UI:** - -## Features - -- Organize audiobooks by author, series, or custom tags -- Track progress across devices — pick up where you left off -- Background playback and sleep timer (mobile apps) -- Support for MP3, M4B, OPUS, and other common formats - -## Getting Started - -1. Open in your browser or mobile app. -2. Click **Sign In** and choose **Sign in with The Nest**. -3. Start listening! - -## Mobile Apps - -- **Android:** [Audiobookshelf Android](https://github.com/advplyr/audiobookshelf-android) (official) -- **iOS:** Third-party clients like [Foliate](https://github.com/johnfactotum/foliate) or [AntennaPod](https://antennapod.org/) (for podcasts) - -## Tips - -- **Syncing progress:** Make sure you're signed into the same account on all devices for seamless cross-device sync. -- **Bookmarks:** You can set bookmarks on any audiobook chapter via the mobile app or web player. - -## 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: - -- **[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 +**Audiobookshelf** is the dedicated audio library server for **The Nest**. It organizes your personal audiobook and podcast collections, tracks listening progress seamlessly across all your devices, and supports background playback. --- -*TODO: Add screenshot of Audiobookshelf library view.* +## 1. Getting Started & Signing In + +Accessing Audiobookshelf is quick and simple using your central Nest account: + +1. Open **[lyrebird.mynest.love](https://lyrebird.mynest.love)** in your Web browser or mobile app. +2. Click **Sign In** and select **"Sign in with The Nest"**. +3. Authenticate using your standard Nest passkey. +4. Pick a book or podcast episode and start listening! + +--- + +## 2. Recommended Mobile Apps + +To take your audiobooks and podcasts on the go, connect your smartphone using one of the recommended client apps: + +### Android +* **Audiobookshelf (Official):** Available on the [Google Play Store](https://play.google.com/store/apps/details?id=com.audiobookshelf.app) or [GitHub Releases](https://github.com/advplyr/audiobookshelf-android). Offers full feature parity including offline downloads and progress sync. + +### iOS (iPhone & iPad) +* **Dedicated iOS Clients:** Native iOS apps like **Plappa**, **ShelfPlayer**, **AudioBooth**, or **Absorb** connect directly to your server. +* **Server Connection:** When configuring any mobile client, set your server URL to: + `https://lyrebird.mynest.love` + +> [!NOTE] +> **Connecting Mobile Apps:** +> When logging in via mobile apps, select the option to sign in via **OpenID / Single Sign-On** to authenticate using your standard Nest passkey. + +--- + +## 3. Features & Listening Tips + +* **Cross-Device Syncing:** Your listening progress, current chapter, and playback speed automatically sync between the Web interface and mobile apps. Just ensure you are signed into the same Nest account on each device! +* **Bookmarks & Notes:** Set custom bookmarks with optional notes on any chapter to easily jump back to favorite moments. +* **Sleep Timers & Playback Speed:** Fine-tune your listening experience with customizable playback speeds and chapter-based sleep timers. + +--- + +## 4. Where Does Content Come From? + +Audiobookshelf draws its library directly from central storage on The Nest. + +Want to add a new audiobook to the library? +* You can request new titles through **[Shelfmark](../media-request/shelfmark.md)**! +* Once requested, Shelfmark automatically processes the audiobook and populates it directly into your Audiobookshelf library. + +--- + +## 5. Service Summary & Related Links + +| Component | URL / Endpoint | Description | +| :--- | :--- | :--- | +| **Audiobookshelf Web UI** | [lyrebird.mynest.love](https://lyrebird.mynest.love) | Web player, library management, and account settings | + +### Related Nest Documentation: +* **[Shelfmark](../media-request/shelfmark.md):** Request new audiobooks to automatically populate your library. +* **[Calibre-Web](../media-and-entertainment/calibre-web.md):** Read e-books and digital publications on your e-reader or mobile device.