Skip to main content

Books, Comics, eBooks & Audiobooks

When a watched root has Books enabled, the scanner handles three distinct kinds of files:

  • Comic archives.cbz and .zip — whose pages and chapters live as image files inside the archive.
  • Single-file books (eBooks).epub and .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 sectionShows
BooksEverything (comics, manga, eBooks, novels, and audiobooks).
ComicsBook types comic and manga.
eBooksBook 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
LayoutBecomes
book.cbz at the rootA standalone single book.
Series/Chapter.cbzBook named after the folder, with each archive a chapter.
Series/Volume NN/Chapter.cbzBook → Volume → Chapter.

ComicInfo.xml

A ComicInfo.xml at the root of the archive enriches the entity:

Element(s)Used for
Title, SeriesChapter/book title and series grouping (Series can override the folder name).
Number, Count, VolumeIssue/chapter number, total, and volume.
SummaryDescription.
Year / Month / DayNormalized date.
Publisher / ImprintStudio/publisher.
WebLinks.
PageCountPage count.
LanguageISOLanguage.
Writer, Penciller, Inker, Colorist, Letterer, CoverArtist, Editor, TranslatorPeople/creators (split on ;/,).
Genre, Tags, Characters, SeriesGroup, StoryArc, Manga, AgeRatingTags.
AgeRatingFlags 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:

FormatMetadata sourceCover
EPUBVersOne.Epub (title, authors, description)Embedded cover image.
PDFPdfPig (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/.pdf is a standalone book.
  • .epub/.pdf files 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.

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

LayoutBecomes
Book Title.m4b at the rootA 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 filesOne 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:

  1. Prefer an EPUB/PDF with the same filename stem, such as Dune.epub and Dune.m4b.
  2. Otherwise, attach to the readable Book when that folder contains exactly one EPUB/PDF.
  3. 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:

FormatReaderModes
Comic archiveComic readerPaged (tap zones, swipe, arrows) and vertical webtoon scroll; single or two-page spreads with cover handling.
EPUBfoliate-js reflowable readerPaged or scrolled, adjustable text size, comic-style tap zones; resumes by CFI.
PDFpdf.js readerContinuous 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.