# SuperBookWorm Bundle

The SuperBookWorm Bundle is every format in one subscription: ebooks, audiobooks, comics, manga and anime metadata. It combines the apps from the [eBookWorm](</app/ebookworm/>), [AudioBookWorm](</app/audiobookworm/>), [StoryBookWorm](</app/storybookworm/>) and [ComicBookWorm](</app/comicbookworm/>) bundles, on one set of shared storage.

Because every app sees the same storage at the same paths, you manage one library with a folder per format, rather than three or four separate setups that can't see each other's files.

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

- **Your household reads in every format**: one person on audiobooks, another on manga, another on a Kobo.
- **You want read-along books** (Storyteller) *and* comics, which no smaller bundle has together.
- **You'd rather have every app available** and use the ones you need, than pick a bundle now and change later.

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

## What's in it?

| Format | App | Its job | Sign-in |
| --- | --- | --- | --- |
| Ebooks | [Grimmory](</app/grimmory/>) | Ebook, PDF and comic library: smart shelves, browser reader, OPDS, Kobo and KOReader sync, send to Kindle | Its own accounts |
| Ebooks | [Calibre-Web](</app/calibre-web/>) | A Calibre library in the browser that imports and converts whatever lands in its ingest folder | ElfHosted login, then its own accounts |
| Everything | [BookOrbit](</app/bookorbit/>) | Reader for ebooks, PDFs, comics and audiobooks, with Kobo and KOReader sync | Its own accounts |
| Audiobooks | [Audiobookshelf](</app/audiobookshelf/>) | The audiobook player and library, with phone apps and progress per user | Its own accounts |
| Read-along | [Storyteller](</app/storyteller/>) | Joins an ebook and its audiobook into one EPUB 3 that highlights as the narrator reads | Its own accounts |
| Comics | [Komga](</app/komga/>), [Kavita](</app/kavita/>) | Two readers over the same comics and manga library, with OPDS and reading apps | Their own accounts |
| Comics | [Kapowarr](</app/kapowarr/>) | Tracks every issue of a comic series and files it with names the readers parse | Your ElfHosted login |
| Anime | [Shoko](</app/shoko/>) | AniDB matching, and corrected episode metadata for your own Plex, Jellyfin or Emby | Its own accounts |
| Books | [Chaptarr](</app/chaptarr/>) | Collection manager for audiobooks and ebooks in one library | Your ElfHosted login |
| Books | [AudioBookRequest](</app/audiobookrequest/>) | A request page for audiobooks | Your ElfHosted login |
| Books | [Shelfmark](</app/shelfmark/>) | One search across the providers you configure, saving into a reader's library | Your ElfHosted login |
| All | [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 people read, listen and watch from use their own accounts, so phones, e-readers, reading apps, media server plugins and family members can reach them directly. The management tools sit behind your ElfHosted login.

## How the apps fit together

Every app mounts your own cloud storage at `/storage/rclone/<mount>/` (attached with [magic mounting](</how-to/use-rclone/>)), which is where your library lives, and `/storage/symlinks/`, which holds symlinks only: real files belong on your own storage, and your dashboard warns you if they build up under `/storage/symlinks/`. A layout that keeps every app in agreement:

| Folder | Filed by | Read by |
| --- | --- | --- |
| `/storage/rclone/<mount>/audiobooks` | Chaptarr (add it as a root folder and make it the default), Shelfmark | Audiobookshelf, Storyteller, BookOrbit |
| `/storage/symlinks/audiobooks` | AudioBookRequest and the audiobook search tools, as debrid links | Audiobookshelf, BookOrbit |
| `/storage/rclone/<mount>/books` | Chaptarr (add it as a root folder and make it the default), Shelfmark | Grimmory, BookOrbit |
| `/cwa-book-ingest/` in Shelfmark | Shelfmark | Calibre-Web, which imports and then deletes the file |
| `/bookorbit-bookdock` in Shelfmark | Shelfmark | BookOrbit's Book Dock, where you confirm each match |
| `/storage/rclone/<mount>/comics` | Kapowarr | Komga, Kavita, BookOrbit |
| `/storage/rclone/<mount>/anime` | You | Shoko, and through it your media server |

```
flowchart LR
  subgraph Audiobooks
    CH1[Chaptarr and requests] --> AB["audiobooks folder"]
    AB --> ABS[Audiobookshelf]
    AB --> ST[Storyteller]
  end
  subgraph Ebooks
    SM[Shelfmark] --> BK["books folder"]
    SM --> CWA["Calibre-Web ingest"]
    BK --> GR[Grimmory]
    CWA --> CW[Calibre-Web]
  end
  subgraph Comics
    KP[Kapowarr] --> CM["comics folder"]
    CM --> KO[Komga]
    CM --> KA[Kavita]
  end
  BK --> BO[BookOrbit]
  CM --> BO
```

## How do I use it?

The steps are the same as in the smaller bundles, so this page points you to them rather than repeating them.

1. **Attach your storage** with [magic mounting](</how-to/use-rclone/>) and create `books`, `comics` and (if you use Shoko) `anime` folders.
2. **Claim every app with its own login as soon as your bundle is ready**: Audiobookshelf, Storyteller, Grimmory, BookOrbit, Komga, Kavita and Shoko ask for an admin account on first use, and **Calibre-Web starts with its factory admin login**, whose password you should change straight away (e-reader apps refuse the factory password). Storyteller also wants its own `STORYTELLER_SECRET_KEY` before you create its account; see below.
3. **Audiobooks**: create the Audiobookshelf library and connect Chaptarr, as in the [AudioBookWorm steps](</app/audiobookworm/#how-do-i-use-it>).
4. **Read-along books**: put each EPUB beside its audio and add a Storyteller watch rule, as in the [StoryBookWorm steps](</app/storybookworm/#3-make-your-first-read-along-book>).
5. **Ebooks**: point Grimmory, BookOrbit and Shelfmark at your books folder, as in the [eBookWorm steps](</app/ebookworm/#how-do-i-use-it>).
6. **Comics and anime**: point Komga, Kavita and Kapowarr at your comics folder, and Shoko at your anime folder, as in the [ComicBookWorm steps](</app/comicbookworm/#how-do-i-use-it>).

Quick-paste into Storyteller's environment variables using ElfBot

```
STORYTELLER_SECRET_KEY=<your string here>
```

Generate the value with a password generator or `openssl rand -base64 32`, and set it with [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>) before creating Storyteller's admin account.

> [!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/superbookworm/>)

## How do I access it?

Everything is on your dashboard at [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>). The apps you'll connect devices to:

- Audiobookshelf: [https://your-username-audiobookshelf.elfhosted.com](<https://your-username-audiobookshelf.elfhosted.com>)
- Storyteller: [https://your-username-storyteller.elfhosted.com](<https://your-username-storyteller.elfhosted.com>)
- Grimmory: [https://your-username-grimmory.elfhosted.com](<https://your-username-grimmory.elfhosted.com>)
- Calibre-Web: [https://your-username-calibre-web.elfhosted.com](<https://your-username-calibre-web.elfhosted.com>)
- BookOrbit: [https://your-username-bookorbit.elfhosted.com](<https://your-username-bookorbit.elfhosted.com>)
- Komga: [https://your-username-komga.elfhosted.com](<https://your-username-komga.elfhosted.com>)
- Kavita: [https://your-username-kavita.elfhosted.com](<https://your-username-kavita.elfhosted.com>)
- Shoko: [https://your-username-shoko.elfhosted.com](<https://your-username-shoko.elfhosted.com>)

The rest follow the same pattern, for example [https://your-username-chaptarr.elfhosted.com](<https://your-username-chaptarr.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/superbookworm/>) and these become your personal, clickable links.

## What it doesn't do

- **No books, comics or anime are included.** Bring your own, or connect providers and accounts of your own.
- **No media server is included.** Shoko improves the metadata in a Plex, Jellyfin or Emby server you already run.
- **Storage is yours to attach**, and with every format in one place a large library belongs on your own cloud storage.
- **The readers keep separate libraries.** Several apps can read the same folder, but reading progress and shelves stay in the app where you made them.
- **Not one login for everything.** The apps you read, listen and watch from keep their own accounts.

## 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/>).
