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

Words

Definitions for the terms Prosody uses across the app and documentation.

Prosody uses a small, consistent vocabulary throughout the app and these docs. The full developer glossary lives in GLOSSARY.md in the repository.

Library and editions

WordMeaning
WorkOne book as Prosody knows it, regardless of how many editions you have.
EditionOne file of a work: its text (.epub), its audio (.m4b) or its pages (.pdf).
TextThe .epub edition of a work, read sentence by sentence.
AudioThe .m4b audiobook edition of a work.
PagesThe .pdf edition of a work, displayed one page at a time.
PairA work that has both text and audio. Only a pair is synced.
Edition aloneThe single edition used when a work is not a pair: text first, otherwise pages, otherwise audio.
LibraryYour book folders on the host (ebooks/ and audiobooks/, by author and title).
ShelfmarkA work's <Author>/<Title> folder path in the library.
ShelfEvery catalogued work in your library, as displayed in the app.

Syncing and the press

WordMeaning
PressThe service that touches book files: it walks the library, aligns pairs and builds reading copies.
WalkOne pass by the press over the entire library to discover works and editions.
SyncedA pair whose narrated sentences have been aligned to its audio and passed the spot check.
Spot checkRe-listening to a spread of aligned sentences with a second speech model (Whisper) to confirm the right words are there.
Reading copyThe files the press builds for the reading room: marked text, audio, rendered PDF pages, timeline and cover, stored in PROSODY_COPIES.

Reading and wanting

WordMeaning
Reading roomThe screen where you read or listen to a single work.
PlaceWhere you are in a work: a sentence, an audio timestamp or a page number. One per work across all devices.
NightstandThe works you are currently reading, shown newest first at the top of the shelf.
Set asideTaking a work off the nightstand without finishing it; your place is kept and reopening it puts it back.
Kept copyA reading copy stored whole in a device's browser cache for offline use.
DeviceOne of your own machines, identified by its Tailscale name.
DeskWhere you list books you want and follow them to the shelf.
WantA book on your desk list.