Books, Comics, eBooks & Audiobooks
When a watched root has Books enabled, the scanner handles three distinct kinds of files:
- Comic archives —
.cbzand.zip— whose pages and chapters live as image files inside the archive. - Single-file books (eBooks) —
.epuband.pdf— where the whole book is one self-contained file. - Audiobooks —
.m4b,.m4a, and.mp3— where one file or an ordered set of files becomes the listening rendition of a Book.
Comic archives: .cbz .zip
Single-file books: .epub .pdf
Audiobooks: .m4b .m4a .mp3
These share the Books library but show up under focused sidebar sections:
| Sidebar section | Shows |
|---|---|
| Books | Everything (comics, manga, eBooks, novels, and audiobooks). |
| Comics | Book types comic and manga. |
| eBooks | Book types book and novel, limited to EPUB/PDF formats. |
Book type (Book / Comic / Manga / Novel) and format (Comic Archive / EPUB / PDF / Audio) are also filterable from the library filter drawer. EPUB defaults to type Novel; PDF defaults to type Book; audio-only books default to type Novel; comic archives are Comic/Manga (with ComicInfo.xml's Manga flag taken into account).
Comic archives (.cbz / .zip)
A comic archive is opened and its image members become pages. Recognized page images inside the archive:
.jpg .jpeg .png .gif .webp .bmp .tiff .tif
Folder layout → entity
Folder depth below the root determines the Book → Volume → Chapter structure:
/media/comics/
├── One Shot.cbz → Book "One Shot" (single archive)
│
├── Saga/
│ ├── Chapter 001.cbz → Book "Saga" › Chapter "Chapter 001"
│ └── Chapter 002.cbz → Book "Saga" › Chapter "Chapter 002"
│
└── Berserk/
├── Volume 01/
│ ├── Chapter 001.cbz → Book "Berserk" › Volume "Volume 01" › Chapter
│ └── Chapter 002.cbz → Book "Berserk" › Volume "Volume 01" › Chapter
└── Volume 02/
└── Chapter 003.cbz → Book "Berserk" › Volume "Volume 02" › Chapter
| Layout | Becomes |
|---|---|
book.cbz at the root | A standalone single book. |
Series/Chapter.cbz | Book named after the folder, with each archive a chapter. |
Series/Volume NN/Chapter.cbz | Book → Volume → Chapter. |
ComicInfo.xml
A ComicInfo.xml at the root of the archive enriches the entity:
| Element(s) | Used for |
|---|---|
Title, Series | Chapter/book title and series grouping (Series can override the folder name). |
Number, Count, Volume | Issue/chapter number, total, and volume. |
Summary | Description. |
Year / Month / Day | Normalized date. |
Publisher / Imprint | Studio/publisher. |
Web | Links. |
PageCount | Page count. |
LanguageISO | Language. |
Writer, Penciller, Inker, Colorist, Letterer, CoverArtist, Editor, Translator | People/creators (split on ;/,). |
Genre, Tags, Characters, SeriesGroup, StoryArc, Manga, AgeRating | Tags. |
AgeRating | Flags the book NSFW when it reads as adult/mature/explicit/18+/etc. |
Single-file books (.epub / .pdf)
Each .epub or .pdf scans into one book entity — there are no separate chapter or page entities, because the structure lives inside the file. Title, author, and description are read straight from the file:
| Format | Metadata source | Cover |
|---|---|---|
| EPUB | VersOne.Epub (title, authors, description) | Embedded cover image. |
| PdfPig (title, author, subject) | Rendered from the first page. |
Folder layout → entity
/media/ebooks/
├── Dune.epub → eBook "Dune" (standalone at root)
├── The Hobbit.pdf → eBook "The Hobbit" (standalone at root)
│
└── Mistborn/
├── The Final Empire.epub → Series "Mistborn" › book
├── The Well of Ascension.epub → Series "Mistborn" › book
└── The Hero of Ages.epub → Series "Mistborn" › book
- A root-level
.epub/.pdfis a standalone book. .epub/.pdffiles inside a folder are grouped into a folder-backed book series: the Books library shows the folder once, and its detail page opens into the books inside.
Audiobooks (.m4b / .m4a / .mp3)
Audiobooks are discovered by the Books scanner, not by enabling the music-oriented Audio scanner. Add them anywhere beneath an enabled, recursive Books root such as /media/books. This is the path inside the container; if the host folder is mounted as /srv/media:/media, /media/books corresponds to /srv/media/books on the host.
Use a Books-only watched root for audiobook folders. If Audio is also enabled on the same root, the same files are eligible for music album/track classification.
Recommended manual layout
Keep every multipart audiobook in its own title folder. To give one Book both readable and listening renditions, put the EPUB/PDF and audiobook parts in the same folder:
/media/books/
└── Frank Herbert/
└── Dune/
├── Dune.epub
├── 01 - Arrakis.m4b
├── 02 - Muad'Dib.mp3
└── 03 - The Desert.m4a
An audio-only title uses the same one-folder-per-book rule:
/media/books/
└── Project Hail Mary/
└── Project Hail Mary.m4b
Folder layout → entity
| Layout | Becomes |
|---|---|
Book Title.m4b at the root | A standalone audio-only Book. |
Book Title/*.m4b (or .m4a/.mp3) | One audio-only Book named after the folder; every audio file in that folder is one ordered part. |
Book Title/Book Title.epub plus audio files | One Book with both reading and listening renditions. |
Audio parts are ordered naturally by their full paths, so zero-padded names such as 01, 02, and 03 give predictable playback order. Do not put multipart files from several books in one folder: every unmatched audio file in a subfolder is grouped by that containing folder.
When audio and readable files share a folder, the scanner attaches audio to the readable Book using these rules:
- Prefer an EPUB/PDF with the same filename stem, such as
Dune.epubandDune.m4b. - Otherwise, attach to the readable Book when that folder contains exactly one EPUB/PDF.
- If the folder contains multiple readable books and no filename matches, keep the audio as a separate audio-only Book rather than guessing.
A single audiobook file may live directly at the watched root, but every root-level audio file is treated as a separate Book. Put multipart audiobooks in a title folder.
After copying files outside Prismedia, run a scan from Settings → Watched Libraries, Files, or Jobs. The Book detail page shows the discovered parts in its Listening section.
Reading
Books open in a focused, full-page reader route:
| Format | Reader | Modes |
|---|---|---|
| Comic archive | Comic reader | Paged (tap zones, swipe, arrows) and vertical webtoon scroll; single or two-page spreads with cover handling. |
| EPUB | foliate-js reflowable reader | Paged or scrolled, adjustable text size, comic-style tap zones; resumes by CFI. |
| pdf.js reader | Continuous scroll with selectable text, zoom (fit-width / fit-page / +/- / pinch), gapless toggle, in-document search, working links, download, outline popup; plus a paged mode. Resumes by page. |
Every book remembers where you left off, shows a reading-progress panel (status, percentage, position, Resume / Start Over, read/unread toggle), and a progress bar along its cover in grids. See Playback & Reading.
Books with an audiobook also show Listen or Resume listening. Multipart audio plays in filename order and stores listening progress independently from EPUB/PDF reading progress.