# Storyteller

> Open-source, self-hosted platform that aligns DRM-free ebooks with their audiobooks into read-along books, with a server, web reader, mobile apps and OPDS feeds.

- **Category:** [E-book Management](https://selfhost.directory/e-book-management)
- **Licence:** mit
- **Source model:** Open source
- **Latest version:** mobile-v2.11.13
- **Author:** Shane Friedman
- **Platforms:** Docker, Docker Compose, PikaPods
- **Ports:** 8001 (Storyteller server (web interface and API))
- **Requires:** Whisper.cpp (optional)
- **Tags:** Ebooks, Epub, Opds, Audiobooks, Transcription, Whisper Cpp

## Docker images

- [`registry.gitlab.com/storyteller-platform/storyteller`](https://registry.gitlab.com/storyteller-platform/storyteller) — Main Storyteller server (API + web interface); tag variants add GPU support

## Hardware requirements

- **CPU:** Intel/AMD or ARM64 — up to 4 cores
- **RAM:** 8 GB
- **Storage:** 10 GB (30 GB for CUDA)

## What is Storyteller?

Storyteller turns the DRM-free ebooks and audiobooks you already own into "readaloud" books. Its forced-alignment engine transcribes the narration (whisper.cpp locally by default, or a paid cloud speech service) and produces EPUBs that follow the open EPUB 3 Media Overlay spec, so the text highlights in step with the audio and you can read, listen, or do both while your place stays synced across devices. The platform is three components: a Docker-published API server, a browser interface for managing the library, and iOS/Android reader apps, plus a REST API and OPDS v1.2/v2.0 catalogs for other readers. Libraries support multiple users with per-user permissions, email invites, and optional OAuth/OIDC sign-in; books can be uploaded, imported from another server, or picked up automatically from a watch folder; audio can be transcoded to MP3, AAC or Opus and metadata or covers edited in the UI. Run it with docker run or Docker Compose behind at least 8 GB of RAM, with an optional NVIDIA/AMD/Intel GPU to speed up transcription. DRM-protected books cannot be processed, and the in-browser reader is still labelled experimental.

## Should you self-host Storyteller?

Storyteller scores **59/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#5 of 9** in [E-book Management](https://selfhost.directory/e-book-management).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is mit-licensed.

Its closest alternative on selfhost.directory is [koodo-reader](https://selfhost.directory/project/koodo-reader) (78/100, 28 945 stars). It scores higher overall, so compare the two before you pick. [See Storyteller vs koodo-reader side by side.](https://selfhost.directory/compare/koodo-reader-vs-storyteller)

## Features

- Audio Transcoding
- Automatic import from watch folders
- Cross-device progress sync — Sync happens when devices can reach the Storyteller server's network.
- Ebook–audiobook forced alignment
- GPU-accelerated transcription — x86 only; arm64 uses the CPU variant.
- Local AI transcription
- Metadata and cover editing
- Multi-user library sharing
- Offline Downloads
- OPDS Feed
- Open-standard EPUB 3 Media Overlays output
- REST API
- Switch between reading and listening
- Synchronized text highlighting
- Web reader (◐ partial) — Documented as experimental and may not be stable.

## How to install Storyteller

### Install Storyteller with Docker

Requirements: Docker

Environment variables:

```
STORYTELLER_SECRET_KEY
```

```
# Storyteller requires a secret key for authentication
export STORYTELLER_SECRET_KEY=$(openssl rand -base64 32)
docker run \
  -it \
  --name storyteller \
  -v ~/Documents/Storyteller:/data:rw \
  -p 8001:8001 \
  -e STORYTELLER_SECRET_KEY=$STORYTELLER_SECRET_KEY \
  registry.gitlab.com/storyteller-platform/storyteller:latest
```

Note: Data (database, covers, transcriptions, books) lives in the mounted /data volume.

### Install Storyteller with Docker Compose

Environment variables:

```
STORYTELLER_SECRET_KEY, STORYTELLER_SECRET_KEY_FILE, PUID, PGID
```

```
services:
  web:
    image: registry.gitlab.com/storyteller-platform/storyteller:latest
    volumes:
      - ~/Documents/Storyteller:/data:rw
    environment:
      - STORYTELLER_SECRET_KEY=$STORYTELLER_SECRET_KEY
    ports:
      - "8001:8001"
```

Note: Recommended way to manage an instance long-term; the secret key can instead be read from a file via STORYTELLER_SECRET_KEY_FILE and Docker secrets.

## Storyteller alternatives

- [OpenReader](https://selfhost.directory/project/openreader): A self-hosted open-source document reader that speaks EPUB, PDF, DOCX, text, and Markdown files aloud with word-level highlighting and audiobook export. (compare: https://selfhost.directory/compare/openreader-vs-storyteller)
- [Libratory](https://selfhost.directory/project/libratory): Libratory turns PDFs into M4B audiobooks with chapter markers, read-along highlighting, and bilingual editions. Self-hosted with offline-first TTS and AI. (compare: https://selfhost.directory/compare/libratory-vs-storyteller)
- [Audiobookshelf](https://selfhost.directory/project/audiobookshelf): Open-source, self-hosted media server for audiobooks and podcasts with on-the-fly audio streaming, progress syncing and podcast auto-downloads. (compare: https://selfhost.directory/compare/audiobookshelf-vs-storyteller)
- [textstack](https://selfhost.directory/project/textstack): Self-hosted, open-source e-reader with contextual word explanations, capped SRS flashcards, and offline reading for dense technical books. Supports EPUB, PDF, FB2. (compare: https://selfhost.directory/compare/storyteller-vs-textstack)
- [abs-kosync-bridge](https://selfhost.directory/project/abs-kosync-bridge): BookBridge is a self-hosted, open-source sync engine aligning reading and listening progress across Audiobookshelf, KOReader, Grimmory, BookOrbit. Runs in Docker. (compare: https://selfhost.directory/compare/abs-kosync-bridge-vs-storyteller)
- [listenarr](https://selfhost.directory/project/listenarr): Open-source, self-hosted audiobook manager that searches indexers, sends grabs to qBittorrent or SABnzbd, and organizes an Audible-enriched library automatically. (compare: https://selfhost.directory/compare/listenarr-vs-storyteller)
- [ReadMeABook](https://selfhost.directory/project/readmeabook): Self-hosted audiobook automation: request from Audible catalog, search via Prowlarr, download via torrent/Usenet, import to Plex or Audiobookshelf with metadata. (compare: https://selfhost.directory/compare/readmeabook-vs-storyteller)
- [bookorbit](https://selfhost.directory/project/bookorbit): Open-source, self-hosted reading hub: built-in readers for ebooks, comics and audiobooks, metadata enrichment, and two-way Kobo/KOReader sync across your devices. (compare: https://selfhost.directory/compare/bookorbit-vs-storyteller)

## More in E-book Management

- [Stump](https://selfhost.directory/project/stump): Stump is a free, open-source, self-hosted comics, manga and ebook server with OPDS v1.2/v2.0, readers for EPUB, PDF, CBZ and CBR, and multi-user access control.
- [Autocaliweb](https://selfhost.directory/project/autocaliweb): Self-hosted, open-source web app to browse, read and manage eBooks, eComics and PDFs on a Calibre database, with OPDS, Kobo sync and automated ingest and conversion.
- [BookLore](https://selfhost.directory/project/booklore): BookLore is a self-hosted, open-source digital library for EPUBs, PDFs and comics, offering smart shelves, automatic metadata, OPDS, Kobo sync, and a built-in reader.
- [Calibre Web](https://selfhost.directory/project/calibre-web): Open-source, self-hosted front-end for browsing, reading, converting and sharing ebooks from a Calibre database, with OPDS access and per-user permissions.
- [docker-calibre-web](https://selfhost.directory/project/docker-calibre-web): Self-hosted web application for managing and reading eBooks through a clean browser interface. Works with Calibre databases and supports Google Drive integration.
- [DVinyl](https://selfhost.directory/project/dvinyl): DVinyl is a modern, self-hostable collection manager designed for physical media enthusiasts. From Vinyls and CDs to Books, Movies & Video games catalog, value and organize your entire physical library through a single, customizable interface.
- [ebook2audiobook---Legacy](https://selfhost.directory/project/ebook2audiobook-legacy): Self-hosted, open-source converter that turns ebooks and PDFs into audiobooks using multiple TTS engines, voice cloning, OCR and 1158 languages.
- [Kavita](https://selfhost.directory/project/kavita): Self-hosted, open-source reading server that organizes and serves your comics, manga, ebook and PDF collection with built-in readers, OPDS and OIDC multi-user logins.
- [Kindle Comic Converter](https://selfhost.directory/project/kcc): Open-source, self-hosted comic and manga converter turning CBZ, PDF or image folders into margin-free MOBI, EPUB, KEPUB or PDF for Kindle, Kobo and reMarkable readers.
- [koodo-reader](https://selfhost.directory/project/koodo-reader): Open-source, cross-platform ebook manager and reader you can self-host with Docker; reads EPUB, PDF, MOBI and CBZ, with notes, OPDS and cloud sync.
- [LANraragi](https://selfhost.directory/project/lanraragi): Web application for archival and reading of manga/doujinshi. Lightweight and Docker-ready for NAS/servers.
- [Libratory](https://selfhost.directory/project/libratory): Libratory turns PDFs into M4B audiobooks with chapter markers, read-along highlighting, and bilingual editions. Self-hosted with offline-first TTS and AI.

## Links

- [Homepage](https://gitlab.com/storyteller-platform/storyteller)
- [Website](https://storyteller-platform.dev/)
- [Demo](https://demo-storyteller.elfhosted.com)
- [Discord](https://discord.gg/KhSvFqcrza)
- [iOS app](https://apps.apple.com/us/app/storyteller-reader/id6474467720)
- [Android app](https://play.google.com/store/apps/details?id=dev.smoores.Storyteller)
- [Documentation](https://storyteller-platform.dev/docs/welcome)
- [GitLab repository](https://gitlab.com/storyteller-platform/storyteller)
- [Blog](https://storyteller-platform.dev/blog)

---
Source: https://selfhost.directory/project/storyteller