wrolpi-help/docs/other/ebooks.md
Roland 0bb877057b
Document resuming where you left off, and recently_viewed.yaml
A new page explains what WROLPi remembers for videos, audio, EPUB eBooks and
comic books, how resume works (and when it does not), `?t=`, progress bars,
the Dashboard's Continue view, and the recently_viewed.yaml config.  The
configs page lists the new config, and PDFs and eBooks link to the page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 18:22:28 -06:00

1.1 KiB

eBooks

eBooks are managed by the Docs module, where they can be browsed, filtered by author and subject, searched, and read directly in the browser with the built-in EPUB reader.

Epub files are desired as ebooks, though some support for Mobi files is provided. Reasons why WROLPi prefers Epub:

  • Epub files are simple. An Epub file is a zip file containing HTML files.
  • Third-party support for reading Epubs is much more feature-rich.
  • Images are files in the Epub zip.
  • Device support for Epubs is nearly ubiquitous.
  • Because an Epub contains HTML files, it makes it easy to display them in a web browser.

EPUB eBooks and comic books open on the page you were reading; see Resume Where You Left Off.

Cover images are detected automatically — including Calibre-style directories with a cover.jpg — see Cover Images.

Searching

When indexes for an eBook are generated, they are searched in the following order of precedence:

  1. Title
  2. Author
  3. File name
  4. eBook contents