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

On your phone, and offline

Installing Prosody to a phone home screen, lock-screen playback, offline reading and keeping books on a device.

Prosody is a web app that installs directly from your browser. Once installed, it opens full screen, shows playback controls on the lock screen and works without a network connection.

Installing on a phone

There is no app store listing. Make sure Tailscale is running on your phone, open your Prosody address in the browser and add it to the home screen:

  • iPhone or iPad (Safari): Tap Share, then Add to Home Screen.

  • Android (Chrome): Open the browser menu, then tap Add to Home screen or Install app.

Lock-screen playback

While audio is playing, Prosody publishes the book's title, author, current chapter and cover to the system media controls, along with play, pause, skip back 15 seconds, skip forward 30 seconds and scrub controls.

Reading without a network

A service worker caches the app shell so Prosody opens even when your device is offline. When it cannot reach your host:

  • The side panel displays Offline: Your place is kept on this device, and sent when you are back.

  • The shelf shows the books you have kept on that device under Can't reach the shelf. These are the books kept on this device.

  • Every place you reach while offline is stored in local browser storage and sent to the host as soon as the connection returns.

Keeping a book on a device

To read or listen offline, open a book while online and click Keep on this device in its side panel. Prosody downloads the book's entire reading copy into browser cache storage: its text, timeline, cover, rendered PDF pages and audio (fetched in 8 MB pieces).

While downloading, the side panel shows progress and a Stop button. Once stored, the shelf displays the total space used (Kept on this device: <n> books, <size>.).

Edition typeTypical size on device
Synced book or audio aloneRoughly the size of its .m4b file
Text alone (EPUB)A few megabytes
Printed pages (PDF)Depends on page count; each page is stored as a 1600 px JPEG

To free space, open the book and click Remove it. Removing a kept copy deletes only the browser cache on that device; your reading place and the copy on your host are untouched.

Limits to keep in mind

  • Phone audio is lightly tested. Background playback, lock-screen controls and offline playback have only been verified on an iPhone in short runs of one to four minutes. Long sessions, interruptions (calls, other apps, Bluetooth) and Android playback are untested.

  • Browser storage eviction. Prosody requests persistent storage when keeping a book, but a mobile browser may still evict site caches when the device runs low on space. If that happens, keep the book again when you are back online.

  • Native app. There is no native mobile app yet; a native iOS app is planned next.