Storyteller

Synced narration for ebooks you own, honestly reviewed. Including the part where the original project was archived.

TL;DR

• What it is: A self-hosted platform that takes audiobooks and ebooks you already own and automatically synchronizes them — audio narration highlights the matching text in real time [1].
• Who it’s for: Readers who want to follow along with audiobooks in text form, or switch between listening and reading without losing their place [1].
• Cost: Free. MIT-licensed. You provide the server and the books.
• Key strength: The concept genuinely solves a real problem — losing your place in an audiobook and having to scrub back. One user described it as the only app they’d found that actually fixed this [1].
• Key weakness: The original GitLab repository (smoores/storyteller) is archived and read-only. If the project has moved or been handed off, continuity is unclear. At 147 GitLab stars, this is a small, lightly-reviewed project — not a mature platform with an active community behind it.
• Verdict: Worth knowing about as a concept. Risky to bet your reading workflow on given the archived status.

---

What is Storyteller

Storyteller is a self-hosted platform built around a specific and underserved problem: you own an audiobook and an ebook of the same title, but no software will connect them. You want to listen during your commute and read when you sit down, without spending ten minutes finding where you left off. Or you want to follow the text visually while the audio plays, so your brain doesn’t drift.

Storyteller solves this by synchronizing the two files. You upload your ebook (EPUB) and audiobook, and the platform analyzes them to build a time-coded overlay — when the audio reaches a sentence, that sentence is highlighted in the text. The output is an EPUB 3 file with Media Overlays, an open standard that any compliant ebook reader supports [1].

The platform is made of three components: an API server that handles synchronization and storage, a web interface for managing your library, and dedicated mobile apps for reading and listening [1]. You run the server yourself. Your books stay on your hardware. There is no cloud service to trust with your library, no subscription to pay, no DRM layer to fight.

The project was created by Shane Friedman and first published on GitLab in May 2021 under an MIT license. The original repository (gitlab.com/smoores/storyteller) is now archived and read-only. AlternativeTo lists a separate platform-level repository (gitlab.com/storyteller-platform/storyteller) as the official source, suggesting some form of handoff or continuation — but the current state of active development is unclear from public-facing information alone [1].

---

Why People Choose It

The honest answer is that there’s very little third-party coverage of Storyteller. In researching this review, one substantive user account surfaced [1]. That account is worth reading in full because it’s precise about the problem:

“If you ever wished you could listen to an Audiobook and read the e-book at the same time with the spoken lines highlighted in the book in sync, then this is the app for you. Storyteller has solved the problem I had with Audiobooks where I would lose track of what was said and then had to skip back again and again.” [1]

The user goes on to note that it’s practical for travel: listen while walking, read while seated, without losing sync. That’s a specific and real use case that commercial apps have mostly ignored. Audible and Kindle are both Amazon products and still don’t reliably sync across the two formats. Whispersync exists but only for a subset of titles and requires both purchases through Amazon. Storyteller solves this for any books you already own in both formats, regardless of where you bought them [1].

The AlternativeTo listing shows 24 likes and 65 alternatives tracked against it — the alternatives list suggests it competes with or complements Thorium Reader, calibre, KOReader, and newer apps like Anthology and BookShelves [1]. The iOS app carries a 4.97 average rating, though the review count isn’t published on AlternativeTo.

That’s the complete picture from external sources. There are no deep dives, no independent benchmarks, no Reddit threads with setup walkthroughs that surfaced in this review’s research. For a 2021-vintage self-hosted tool with 147 stars, that absence is itself a data point.

---

Features

Based on the AlternativeTo description and project README (via archived GitLab):

Core sync engine:

• Automatic synchronization between ebook (EPUB) and audiobook files you already own [1]
• Outputs EPUB 3 files with Media Overlays — an open standard, not a proprietary format [1]
• The synchronized file can be read in any EPUB reader supporting Media Overlays, including hardware e-readers [1]

Reading experience:

• Current narration position highlighted in text in real time [1]
• Switch between listening-only and reading-along without losing position [1]
• Dedicated iOS and Android mobile apps for the full experience [1]
• Web interface for library management [1]

Ownership and portability:

• Fully self-hosted — no external servers see your library [1]
• Synced files are standard EPUB 3 — you can move, copy, and back them up freely [1]
• MIT license — no license keys, no activation, no vendor relationship [1]

What’s absent or unconfirmed:

• REST API for programmatic access: not documented in available sources
• Multi-user support: unclear
• Batch processing / automation for large libraries: not mentioned
• Linux/Windows client apps: only mobile apps referenced [1]

---

Pricing: SaaS vs Self-Hosted Math

There is no SaaS tier. Storyteller is MIT-licensed software you run yourself. The cost structure is simple:

• Software: $0
• Infrastructure: Whatever a VPS costs you. A $5–6/mo Hetzner or Contabo instance is sufficient for a personal library server.
• Books: You need both an audiobook and an ebook for each title. This is the actual cost barrier — not the software.

The commercial alternative math:

There is no direct commercial equivalent that does exactly what Storyteller does. The closest analog is Amazon’s Whispersync, which requires purchasing Kindle editions and Audible editions through Amazon, and only works for titles Amazon has matched. If you’ve bought DRM-free audiobooks from Libro.fm or downloaded EPUB files, Whispersync doesn’t apply. Storyteller works with files you own regardless of source.

For a reader with 20–50 synced titles, the alternative is either the Amazon ecosystem lock-in or no sync at all. Storyteller’s cost is effectively your VPS bill plus setup time.

---

Deployment Reality Check

Storyteller is a three-component stack: API server, web interface, and mobile apps. The API server requires a host with persistent storage for your book files. Based on the project’s architecture, Docker-based deployment is the expected path, though specific setup documentation is tied to the GitLab repository which is now archived.

What you need:

• A Linux VPS or home server with enough storage for your book collection (audiobooks are large — a single title can be 300–500MB)
• Docker or equivalent container runtime
• A domain or local network address for the web interface
• Your book files in compatible formats

What can go wrong:

• The original repository is archived. If you hit a bug or an incompatibility with a newer OS or Docker version, there is no upstream to file an issue against. The platform-level repository (gitlab.com/storyteller-platform/storyteller) may be active, but its maintenance status requires independent verification before you commit to it [1].
• The synchronization process — aligning audio timestamps to text positions — is computationally nontrivial. Quality will vary with audiobooks that have unusual pacing, background music, or narrators who deviate from the text.
• Mobile apps on iOS are available (4.97 rating on the App Store as of AlternativeTo’s last update) but app continuity depends on whoever is maintaining the platform fork [1].
• Community support is thin. With 147 stars and minimal public discussion, troubleshooting a non-obvious setup problem means reading source code.

Realistic time estimate for someone comfortable with Docker: 1–3 hours for a working instance. For someone following documentation on a first Linux server: plan for a full afternoon and check whether the platform fork’s documentation is current before starting.

---

Pros and Cons

Pros

• Solves a real, neglected problem. Synchronized ebook + audiobook reading with text highlighting is genuinely useful and not available in any mainstream commercial tool without Amazon lock-in [1].
• MIT licensed. You can fork it, modify it, run it forever without a vendor relationship [1].
• EPUB 3 output is portable. The synchronized files are standard and readable in third-party apps — you’re not locked into Storyteller’s own reader [1].
• Self-hosted means your library is private. No service learns what you’re reading or for how long [1].
• iOS app with near-perfect ratings. The 4.97 average suggests the reading experience, when it works, works well [1].
• Ownership model. Works with audiobooks and ebooks from any source, not just a specific retailer’s catalog [1].

Cons

• Original repo is archived. The primary development repository is frozen. Ongoing maintenance depends on a community fork with unclear activity levels [1].
• 147 GitHub stars. This is a small, lightly-adopted tool. Contrast with calibre (17,000+ GitHub stars) or KOReader (18,000+). The community is small enough that long-term maintenance is a real question.
• No third-party benchmarks or independent reviews. There’s almost no public record of people running this at scale, hitting edge cases, or stress-testing the sync algorithm. You’d be an early adopter in a quiet community.
• Book format prerequisites. You need DRM-free files in both EPUB and a compatible audiobook format. If your library is DRM-locked from Audible or Kindle, Storyteller can’t help you without DRM removal tools that operate in a legal gray area.
• Setup is not turnkey. Three components to deploy and keep running. No one-click installers surfaced in research.
• Limited alternatives if something breaks. The closest ecosystem for support is the AlternativeTo comments section and whatever activity exists on the platform fork.

---

Who Should Use This / Who Shouldn’t

Use Storyteller if:

• You have a personal library of DRM-free audiobooks and ebooks and want synchronized reading.
• You’re comfortable running a Docker stack on a VPS or home server, and you accept the maintenance trade-off of an archived project.
• The Amazon Whispersync catalog doesn’t cover your reading list, or you’ve consciously chosen to buy outside Amazon’s ecosystem.
• You want complete ownership of your reading data and don’t want any SaaS service tracking your library.

Skip it if:

• You need a project with active upstream maintenance and a real bug tracker. The archived status is a meaningful risk for anything you plan to rely on long-term.
• Your audiobooks are from Audible with DRM. Storyteller can’t process locked files.
• You want a supported, documented setup experience. The community is too small for reliable troubleshooting help.
• You’re a non-technical founder who doesn’t want to manage server software. This project requires more hands-on maintenance than more established self-hosted tools.

Consider alternatives first if:

• You just want good ebook reading without audio sync — calibre and KOReader are vastly more mature.
• You want audiobook management — Audiobookshelf is the clear choice, with 6,000+ GitHub stars and active development.

---

Alternatives Worth Considering

• Audiobookshelf — Self-hosted audiobook and podcast server. Much more mature, actively developed, 6,000+ stars. Doesn’t do ebook/audio sync in the same way, but covers audiobook library management comprehensively.
• calibre — The standard for ebook library management. No audio sync, but handles EPUB conversion, metadata, and device sync better than anything else.
• KOReader — Open-source ebook reader for e-ink devices and mobile. Excellent EPUB support including Media Overlays on compatible hardware.
• Amazon Whispersync — If you’re in the Amazon ecosystem and the titles you want are covered, Whispersync works without any server setup. The trade-off is full vendor lock-in and coverage limited to Amazon’s matched catalog.
• Voice Dream Reader (iOS) — Commercial iOS app that can read EPUB files aloud with text highlighting. Not the same as synchronized narration, but solves a similar problem for users who don’t need server infrastructure.

---

Bottom Line

Storyteller had a genuinely good idea: take two files you already own and connect them in a way no commercial platform bothers to do. The user experience, when it works, appears to deliver on that promise — the sole detailed user account describes it solving exactly the problem it claims to solve [1]. The MIT license and EPUB 3 output are clean choices that prioritize your ownership over any platform dependency.

The problem is the archived status of the original repository and the minimal community around it. At 147 stars with no independent reviews or active forum presence, you’re accepting meaningful maintenance risk. If you build a reading workflow around Storyteller today and a Docker API change breaks the sync engine six months from now, your support path is reading source code or switching tools.

If this project is important to you, verify the current status of the platform fork before committing. If you need audiobook management more broadly, Audiobookshelf is the better-supported choice. If the specific audio-text sync problem matters enough to accept the risk, Storyteller is the only self-hosted tool in this category — and that’s not nothing.

---

Sources

1. AlternativeTo — Storyteller: A self-hosted platform for automatically syncing ebooks and audiobooks (24 likes, 65 alternatives, iOS 4.97 avg rating). alternativeto.net. https://alternativeto.net/software/storyteller/about/

Primary sources:

• GitLab repository (archived): https://gitlab.com/smoores/storyteller (147 stars, MIT license, created May 2021)
• Platform GitLab repository: https://gitlab.com/storyteller-platform/storyteller