Storyteller
Updated
Storyteller is a platform for automatically aligning ebooks and audiobooks for immersive reading, with native Android / iOS apps.
Get a 7-day trial of ElfHosted Storyteller!
Align your audiobooks and ebooks
Switch back and forth between listening and reading without losing your place, or have Storyteller read aloud to you while highlighting the text!
Read or listen however you choose
Storyteller produces EPUB 3 compliant ebook files. You can read them with any ebook reader (software or hardware!) that supports EPUB Media Overlays, or you can use the dedicated Storyteller mobile apps.
How do I access Storyteller?
Storyteller is available:
- From your dashboard: https://your-username.elfhosted.com
- Directly: https://your-username-storyteller.elfhosted.com
Signed-in users see their own URLs
The addresses above show the general pattern. Sign in and these become your personal, clickable links.
Info
Storyteller is an open-source tool. ElfHosted provides hosting infrastructure only. Users are responsible for their use of this service in compliance with applicable laws and third-party terms of service.
How to use Storyteller
Set STORYTELLER_SECRET_KEY
Storyteller uses the STORYTELLER_SECRET_KEY environment variable to secure its authentication. While we provide a strong default, that default is applied to all users, and so you should reset your key before you configure Storyteller.
To set your STORYTELLER_SECRET_KEY, generate a strong random string using or 1Password's online random password generator, or by running openssl rand -base64 32
STORYTELLER_SECRET_KEY=<your string here>
Storyteller will restart, and you can now proceed to setup your admin account.
Transcription
Storyteller has to transcribe your audiobook before it can align it against the ebook text, and that transcription is the slow part of the whole process.
On ElfHosted it runs on our shared GPU transcription service, not on your instance's CPU. That's included in your subscription, it's on by default, and there's nothing to configure. You don't need an OpenAI key, a Deepgram account, or a credit card.
Left to itself, Storyteller ships a bundled whisper.cpp that compiles itself on first use and then transcribes on a single CPU core. That's what "very slow" used to mean here, and it's what the shared service replaces.
Bring your own engine
The shared service is there to get you started. Got a big batch of books, or prefer your own transcription provider? A cloud transcription service of your own is faster for large libraries: ask in Discord and we'll switch your instance off the shared service, after which Storyteller's own transcription settings are yours to set.
Where your readalouds go
A readaloud is the finished book: the ebook with the narration built into it. By default, Storyteller saves each one next to the ebook it was made from, with (readaloud) added to the name.
If you'd rather collect them all in one place on your own storage, go to Settings β Readaloud location, choose In a custom folder, and enter a folder under your rclone mount, for example:
/storage/rclone/<your remote>/readalouds
<your remote> is the name you gave your storage in rclone.
Books uploaded in the browser stay inside Storyteller
This setting only applies to books whose ebook lives on your storage. If you upload an ebook through Storyteller's web page, Storyteller keeps it (and its readaloud) in its own folder, whatever you choose here. To have readalouds land on your storage, import books from your storage instead, as below.
Using Storyteller with Audiobookshelf
If your audiobooks are already in Audiobookshelf, Storyteller can pick up books from the same folders, so there is only one library to keep.
Storyteller pairs an ebook with an audiobook when they are in the same folder. It does not match by title. So the setup is:
- Put each book's EPUB in its Audiobookshelf folder, next to the audio files. Audiobookshelf shows it as that book's ebook, too.
- Tell Storyteller to watch your audiobooks folder. Under Settings β Import rules, add a watch rule for your Audiobookshelf library folder, for example
/storage/rclone/<your remote>/audiobooks, with import mode Reference. Reference means Storyteller reads your files where they are rather than copying them. - Send readalouds somewhere else, using a custom folder as described above. That keeps a second EPUB out of each Audiobookshelf folder.
- Scan regularly. Storyteller only notices files added from elsewhere (by Audiobookshelf, or through rclone) when it scans. Under Settings β Library scanning, turn on Run scans on a schedule and choose an interval, for example every 60 minutes.
Each folder with both an EPUB and an audiobook then shows up in Storyteller as one book. Alignment still starts when you ask for it: open the book and choose Create readaloud, or select several books and use Begin processing.
Older EPUB 2 ebooks
Storyteller needs EPUB 3. When it imports an EPUB 2 file it converts it, and by default it keeps the original beside it with _epub2 added to the name. Audiobookshelf will list that copy too. If your originals are safe elsewhere, you can remove the _epub2 copies once the book has imported.
Storyteller also works with
How do I get support for Storyteller?
-
For general use of Storyteller, refer to the official site or to one of the links in the resources section below.
-
For specific support re your ElfHosted configuration / account, see the ElfHosted support options!
Sponsor Storyteller β€οΈ
You can contribute directly to the development of Storyteller using the following:
Storyteller resources
What users say..
We're rocking some excellent TrustPilot Reviews, and here's what some of our
usersfriends say..
It's been a great experience overall.
There was a minor problem when I chose to migrate locations and the support team promptly solved it. Excelent customer service.
When I first experienced ElfhostI was extremely overwhelmed with the experience. But overtime I have gained a huge respect for who they are and what they do! These folks are extraordinary at what they do and I take my hat off to them! Keep up the GREAT work you all!
I have two left hands. But thanks to the amazing support i was able to get all of this running in no time! Special Thanks to Togx90 ur a Hero! This was the best customer support i habe ever seen. Great Service!
It's obvious how much work the team has put into to automating and running this. It's probably one of the smoothest deployments of anything this remotely complex I've seen.