-
Notifications
You must be signed in to change notification settings - Fork 1
Feature #43: Extract and display cover images from EPUB/AZW3 #121
Copy link
Copy link
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Description
EPUB and AZW3 books show format placeholder icons instead of actual cover images in the library.
Current State
- Custom user covers (uploaded via PhotosPicker): ✅ Working (Feature Bug #103: TOC jumps to wrong chapter + wrong position + position restore broken #30)
- Extracted EPUB covers: Not implemented —
EPUBMetadataExtractoris a stub returning nil - Extracted AZW3 covers: Not implemented —
AZW3MetadataExtractoris a stub returning nil
Infrastructure Already In Place (~40%)
Book.coverImagePath: String?— model field exists, always nilBookMetadata.coverImagePath: String?— metadata field exists, never populatedCustomCoverStore— JPEG compression, disk storage, cleanup — fully workingBookCardView/BookRowView— already check for cover image, fall back to placeholder- Import pipeline passes
coverImagePaththrough, just receives nil
What's Missing
- EPUB cover extraction — Parse
content.opffor cover image reference, extract from ZIP - AZW3 cover extraction — Read EXTH records for embedded cover, or use Foliate-js
- Save extracted cover to disk during import (via CustomCoverStore or similar)
- Populate
Book.coverImagePathinBookImporter.importFile()
Notes
- EPUB cover extraction may be addressed by Feature Bug #11: Large TXT file nearly impossible to scroll #42 (Foliate-js engine) if Foliate exposes covers
- AZW3 cover extraction depends on Foliate-js or native MOBI header parsing
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request