Prosody
All of the docs
  1. What Prosody is
  2. What you need
  3. Installing
  4. Signing in
  5. Adding books
  6. Syncing a book
  7. Reading and listening
  8. On your phone, and offline
  9. How the aligner works
  10. When something is wrong
  11. Updating and backing up
  12. Where books come from
  13. Words

Where books come from

DRM-free sources for ebooks and audiobooks that work with Prosody, and how to prepare matching editions.

Prosody reads plain, DRM-free files that you own:

  • Ebooks: .epub

  • Audiobooks: .m4b encoded in AAC-LC (one file per book)

  • PDFs: .pdf

Prosody does not strip DRM and cannot open DRM-locked files. Books locked inside a proprietary app generally cannot be exported into your library.

DRM-free audiobooks

SourceNotes
Libro.fmSells DRM-free audiobooks downloadable as M4B or MP3, with purchases supporting a local bookshop of your choice.
DownpourSells DRM-free audiobooks as M4B or MP3.
LibriVoxFree public-domain audiobooks read by volunteers.
Your own CDsRip and combine into a single AAC-LC .m4b.

DRM-free ebooks

SourceNotes
Standard EbooksFree, carefully typeset public-domain EPUBs.
Project GutenbergFree public-domain EPUBs.
KoboOffers selected titles without DRM (listed on each title's store page).
Direct from publishersSeveral independent and technical publishers sell DRM-free EPUBs directly.

Choosing editions that pair well

For Prosody to sync a book, the EPUB and the audiobook must share the same text: unabridged, and the same translation for translated works. Check edition details before buying a second format.

To try Prosody quickly with a free pair, the opening of Moby-Dick on the front page uses a public-domain text paired with Stewart Wills's LibriVox recording.

Converting MP3 chapters to M4B

Prosody expects one .m4b file per audiobook. If you download an audiobook as a folder of MP3 tracks, join them into a single AAC-LC .m4b (preserving chapter markers if your tool supports it) using ffmpeg or a dedicated audiobook joiner, then place the .m4b in audiobooks/<Author>/<Title>/.

Optional fetching from the desk

If you already run external services for fetching books, the desk can optionally be wired to them. That feature is off unless configured; see docs/acquiring in the repository for setup details.