selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Storyteller logo

Self-host Storyteller

mobile-v2.11.13

Ebooks and audiobooks aligned so text follows narration

ReleaseOpen Sourcemit
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
Updated3 weeks ago
Setup difficultyModerate
MobileNative app
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))
Docker
registry.gitlab.com/storyteller-platform/storyteller
Library settings: naming the library and setting its web URLTranscription settings: engine and Whisper model selectionAuthentication provider settingsAudio settings: preferred codec and track splitting

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.

Storyteller alternatives

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

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

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

How to configure Storyteller

  • STORYTELLER_SECRET_KEYThe secret key for the instance. Either this or STORYTELLER_SECRET_KEY_FILE must be set.
  • STORYTELLER_SECRET_KEY_FILEPath to a file containing the secret key for the instance. Either this or STORYTELLER_SECRET_KEY must be set.
  • PUID1000The uid of the user to run Storyteller as.
  • PGID1000The gid of the user to run Storyteller as.
  • READIUM_PORT8002Port for the Readium server.

More in E-book Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…