Self-host Storyteller
mobile-v2.11.13Ebooks and audiobooks aligned so text follows narration
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- CPU
- Intel/AMD or ARM64 — up to 4 cores
- RAM
- 8 GB
- Storage
- 10 GB (30 GB for CUDA)
- Port
- 8001 (Storyteller server (web interface and API))
registry.gitlab.com/storyteller-platform/storytellerWhat 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.
Storyteller alternatives
OpenReaderA self-hosted open-source document reader that speaks EPUB, PDF, DOCX, text, and Markdown files aloud with word-level highlighting and audiobook export.CompareOpenReader with Storyteller
LibratoryLibratory turns PDFs into M4B audiobooks with chapter markers, read-along highlighting, and bilingual editions. Self-hosted with offline-first TTS and AI.CompareLibratory with Storyteller
AudiobookshelfOpen-source, self-hosted media server for audiobooks and podcasts with on-the-fly audio streaming, progress syncing and podcast auto-downloads.CompareAudiobookshelf with Storyteller
textstackSelf-hosted, open-source e-reader with contextual word explanations, capped SRS flashcards, and offline reading for dense technical books. Supports EPUB, PDF, FB2.Comparetextstack with Storyteller
abs-kosync-bridgeBookBridge is a self-hosted, open-source sync engine aligning reading and listening progress across Audiobookshelf, KOReader, Grimmory, BookOrbit. Runs in Docker.Compareabs-kosync-bridge with Storyteller
listenarrOpen-source, self-hosted audiobook manager that searches indexers, sends grabs to qBittorrent or SABnzbd, and organizes an Audible-enriched library automatically.Comparelistenarr with Storyteller
ReadMeABookSelf-hosted audiobook automation: request from Audible catalog, search via Prowlarr, download via torrent/Usenet, import to Plex or Audiobookshelf with metadata.CompareReadMeABook with Storyteller
bookorbitOpen-source, self-hosted reading hub: built-in readers for ebooks, comics and audiobooks, metadata enrichment, and two-way Kobo/KOReader sync across your devices.Comparebookorbit with Storyteller
Should you self-host Storyteller?
Storyteller scores 59/100 on selfhost.directory (how scoring works) and ranks #5 of 9 in 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 (78/100, 28 936 stars). It scores higher overall, so compare the two before you pick. See Storyteller vs koodo-reader side by side.
Features
- Audio Transcoding
- Automatic import from watch folders
- Cross-device progress syncSync happens when devices can reach the Storyteller server's network.
- Ebook–audiobook forced alignment
- GPU-accelerated transcriptionx86 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 readerDocumented as experimental and may not be stable.
How to install Storyteller
Install Storyteller with Docker
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
Data (database, covers, transcriptions, books) lives in the mounted /data volume.
More in E-book Management
StumpStump 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.
AutocaliwebSelf-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.
BookLoreBookLore 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 WebOpen-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-webSelf-hosted web application for managing and reading eBooks through a clean browser interface. Works with Calibre databases and supports Google Drive integration.
DVinylDVinyl 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---LegacySelf-hosted, open-source converter that turns ebooks and PDFs into audiobooks using multiple TTS engines, voice cloning, OCR and 1158 languages.
KavitaSelf-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 ConverterOpen-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-readerOpen-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.
LANraragiWeb application for archival and reading of manga/doujinshi. Lightweight and Docker-ready for NAS/servers.
LibratoryLibratory turns PDFs into M4B audiobooks with chapter markers, read-along highlighting, and bilingual editions. Self-hosted with offline-first TTS and AI.




0 comments