# AudioBookWorm Bundle

The AudioBookWorm Bundle is an audiobook setup in one subscription. [Audiobookshelf](</app/audiobookshelf/>) is the player and the library. Around it sit the apps that keep that library tidy and growing: [AudioBookRequest](</app/audiobookrequest/>) so the people you share with can ask for a title instead of messaging you, [Chaptarr](</app/chaptarr/>) to follow authors and file books with covers and details, [Shelfmark](</app/shelfmark/>) to search the providers you configure, and [BookOrbit](</app/bookorbit/>) for anyone who also reads.

Every app in the bundle sees the same storage at the same paths, so a book filed by one app is already where the player looks. That shared storage is the point of the bundle: you are not copying files between containers or mapping one app's folder onto another's.

**When does the AudioBookWorm Bundle make sense?**

- **You listen more than you read**, and want one place for the household's audiobooks with progress kept per person.
- **Other people use your library**, and you would rather keep requests on a page than in your messages.
- **You want the collection kept in order** (authors, series, narrators, covers) without doing it by hand.
- **You want the phone apps to work from anywhere**, with no port-forwarding and no machine left on at home.

If you also read ebooks, or want read-along books, look at the [StoryBookWorm Bundle](</app/storybookworm/>). For comics as well, the [SuperBookWorm Bundle](</app/superbookworm/>) has every format.

[Get a 7-day trial of the AudioBookWorm Bundle! 🪄](<https://store.elfhosted.com/product/audiobookworm/>)

## What's in it?

| App | Its job in the bundle | Sign-in |
| --- | --- | --- |
| [Audiobookshelf](</app/audiobookshelf/>) | The player and library: web, iOS and Android apps, progress per user | Its own accounts |
| [AudioBookRequest](</app/audiobookrequest/>) | A request page for audiobooks | Your ElfHosted login |
| [Chaptarr](</app/chaptarr/>) | Collection manager for audiobooks (and ebooks), narrator and edition aware | Your ElfHosted login |
| [Shelfmark](</app/shelfmark/>) | One search across the providers you configure, saving into your library | Your ElfHosted login |
| [BookOrbit](</app/bookorbit/>) | Reader for ebooks, PDFs, comics and audiobooks, with Kobo and KOReader sync | Its own accounts |
| [Prowlarr](</app/prowlarr/>), [Jackett](</app/jackett/>) and search helpers | Keep your provider list in one place for the apps above | Your ElfHosted login |

The apps marked "its own accounts" are the ones you share with other people and connect phone or e-reader apps to, so they are reachable without an ElfHosted login and use their own users instead. Everything else sits behind your ElfHosted login.

## How the apps fit together

Every app mounts the same two trees:

- **`/storage/rclone/<mount>/`**: cloud storage you attach yourself with [magic mounting](</how-to/use-rclone/>) (Google Drive, OneDrive, S3, Backblaze B2 and anything else rclone speaks). This is where your audiobook library lives, so every real file (a book Shelfmark saves, a converted M4B, Chaptarr's covers and `metadata.json`) stays on storage you own.
- **`/storage/symlinks/`**: symlinks only. Tools backed by a debrid account leave links in `/storage/symlinks/audiobooks` by default instead of downloading whole files. Real files don't belong here, and your dashboard warns you if they start to build up.

```
flowchart LR
  R[AudioBookRequest] --> F["/storage/rclone/your-mount/audiobooks"]
  C[Chaptarr] --> F
  S[Shelfmark] --> F
  F --> A[Audiobookshelf]
  L["/storage/symlinks/audiobooks (debrid links)"] --> A
  A --> P[Phone apps and browser]
```

So the flow is: a request, a followed author or a search ends with a book filed in your audiobooks folder, Audiobookshelf picks it up, and it appears on everyone's phone.

## How do I use it?

### 1\. Claim Audiobookshelf first

Open Audiobookshelf from your dashboard. The first visit asks you to create the root user, and because Audiobookshelf answers phone apps directly it is not behind your ElfHosted login, so do this as soon as your bundle is ready.

Attach your cloud storage with [magic mounting](</how-to/use-rclone/>) and create an `audiobooks` folder on it. Then create a library (type **Book**) and add these folders:

- `/storage/rclone/<mount>/audiobooks`, your library on your own storage
- `/storage/symlinks/audiobooks`, if you use a debrid account: the debrid-backed tools leave their links there

Add a user for each person in the household under **Settings → Users**, so everyone keeps their own place in their own books.

### 2\. Connect Chaptarr to Audiobookshelf

Chaptarr arrives with an **Audiobooks** root folder at `/storage/symlinks/audiobooks`. Add a root folder at `/storage/rclone/<mount>/audiobooks` under `Settings → Media Management` and make it the default, because Chaptarr writes Audiobookshelf's own `metadata.json` and cover files as it imports, and those are real files. Then add the Audiobookshelf connection in Chaptarr so each import triggers a scan straight away, following the steps on the [Chaptarr page](</app/chaptarr/#connecting-chaptarr-to-audiobookshelf>).

### 3\. Point Shelfmark at the same folder

Shelfmark saves to its own folder by default, and it saves real copies. Change its destination for audiobooks to `/storage/rclone/<mount>/audiobooks`, the folder Audiobookshelf watches, as described on the [Shelfmark page](</app/shelfmark/>).

### 4\. Set up requests

Open AudioBookRequest and connect it to your hosted Prowlarr (`http://prowlarr:9696`, plus the API key from Prowlarr's `Settings → General`).

AudioBookRequest sits behind your ElfHosted login, so as it arrives the request page is yours. If you want people without an ElfHosted login to make requests, ask in [Discord](<https://discord.elfhosted.com>): it can be switched to its own user accounts instead.

> [!NOTE]
>
> **Full setup guide**
>
> The step-by-step setup is available to logged-in customers. [Sign in to continue →](<https://docs-internal.elfhosted.com/app/audiobookworm/>)

### Apps that start switched off

Jackett arrives switched off, because most setups never need it. Turn it on (or off again) at [store.elfhosted.com/my-account/apps](<https://store.elfhosted.com/my-account/apps/>). Nothing is lost by switching it off.

## How do I access it?

Everything is on your dashboard at [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>). Directly:

- Audiobookshelf: [https://your-username-audiobookshelf.elfhosted.com](<https://your-username-audiobookshelf.elfhosted.com>) (use this address in the Audiobookshelf phone apps)
- AudioBookRequest: [https://your-username-audiobookrequest.elfhosted.com](<https://your-username-audiobookrequest.elfhosted.com>)
- Chaptarr: [https://your-username-chaptarr.elfhosted.com](<https://your-username-chaptarr.elfhosted.com>)
- Shelfmark: [https://your-username-shelfmark.elfhosted.com](<https://your-username-shelfmark.elfhosted.com>)
- BookOrbit: [https://your-username-bookorbit.elfhosted.com](<https://your-username-bookorbit.elfhosted.com>)
- Prowlarr: [https://your-username-prowlarr.elfhosted.com](<https://your-username-prowlarr.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/audiobookworm/>) and these become your personal, clickable links.

## What it doesn't do

- **No audiobooks are included.** The bundle is the shelf, not the books. Bring files you own, or connect accounts and providers of your own.
- **No storage is included for a big collection.** Attach your own with [magic mounting](</how-to/use-rclone/>) if your library is large or already lives in the cloud.
- **A debrid account is optional and not included.** The bundle works without one.
- **Not every app shares one login.** Audiobookshelf and BookOrbit use their own accounts so phones, e-readers and family members can reach them.

## How do I get support?

1. Each app's own page (linked above) covers it in more detail, along with its upstream project's documentation.
2. For your ElfHosted setup, see the [ElfHosted support options](</get-help/>).

> [!NOTE]
>
> **Your content, your responsibility**
>
> ElfHosted hosts the apps in this bundle. We do not supply content, accounts, or third-party credentials. You are responsible for ensuring that your use of these apps complies with applicable laws and our [Acceptable Use Policy](</legal/acceptable-use/>).
