Digital Books¶

Create and maintain a structured, accessible digital library of various book types hosted on an Unraid server. The project includes acquisition, metadata tagging, file formatting/editing, and access through web or mobile services and apps.

Core Concepts & Workflow¶

Area	Description
Collection	Acquiring digital versions of books (legal sources, scans, PDFs, EPUBs, CBZs, etc.)
Cataloging	Tagging with author, title, genre, series, format, language
Editing	Converting formats (PDF to EPUB/CBZ), merging volumes, compressing
Hosting	Using apps (e.g., Kavita, Calibre-Web, Komga) on Unraid for serving content
Viewing	Testing across devices (tablet, phone, web reader, eReader)
Organization	Structuring folders, maintaining consistent naming, genre sorting
Maintenance	Updates, backups, indexing, library syncs

Issue Categories¶

Issue Category	Description
01 - Book Acquisition	Find, scan, or download eBooks and comics
02 - Metadata & Tagging	Use tools like Calibre to tag and rename books
03 - Format Standardization	Convert to preferred formats (EPUB, PDF, CBZ, MOBI)
04 - Server Setup	Deploy Kavita or Calibre-Web on Unraid
05 - Device Testing	Verify usability on eReaders, phones, tablets, browsers
06 - Deduplication & Cleaning	Merge duplicate entries, standardize series names
07 - Organization by Type	Genre and media-type folder structures (e.g., comics vs. cookbooks)
08 - Wiki & Docs	Maintain guide for naming, formats, reader compatibility

Folder & File Naming Standard¶

/mnt/user/Books/
├── Comics/
│   └── Batman (2016)/
│       ├── Batman 001.cbz
│       ├── Batman 002.cbz
│       └── metadata.json
├── Cookbooks/
│   └── [Author] - The Pasta Book (2022).pdf
├── Manga/
│   └── One Piece/
│       ├── Vol 01.cbz
│       ├── Vol 02.cbz
├── Fiction/
│   └── [Author] - Book Title.epub
├── Non-Fiction/
│   └── [Author] - How Things Work.pdf
├── RPGs/
│   └── D&D 5e/
│       ├── Player's Handbook.pdf
│       └── Dungeon Master's Guide.pdf

Book Types and Format Guidelines¶

Type	Preferred Format	Notes
Comics	CBZ/CBR	Use Kavita/Komga
Cookbooks	PDF	Layout important
Manga	CBZ	Folder per series, volume tagged
TTRPGs	PDF	High-resolution scan, OCR
Fiction	EPUB	Reflowable, supports metadata
Non-Fiction	PDF or EPUB	Depends on layout
How-To Books	PDF	Keep images crisp

Server & Apps¶

App	Purpose
Kavita	Manga, comics, general book reader
Calibre-Web	Library browsing for EPUBs & PDFs
Komga	Alternative for comics/manga (more flexible UI)
OCRmyPDF	Makes scanned TTRPG PDFs searchable
Filebot	Bulk renaming of files
Rclone	Cloud sync for book backups

Viewing/Access Testing¶

Device	Test Criteria
Tablet (iOS/Android)	Full-page view for comics, zoom support
eReader (Kobo/Kindle)	EPUB support, PDF scaling
Browser (Desktop)	Metadata visible, search functionality
Smartphone	Easy navigation and zoom for CBZs

Milestones¶

Milestone	Description
Phase 1	Upload and tag 500 core books
Phase 2	Calibre-Web and Kavita hosted via Unraid
Phase 3	Full metadata imported and search tested
Phase 4	Remote access and backups configured
Phase 5	Final structure documented in wiki

Example Documentation Topics (for Wiki)¶

• Comic/Manga series folder standards
• EPUB vs PDF use cases
• Kavita setup and reader features
• OCR process for RPG manuals
• Metadata standards for books
• Troubleshooting reader apps