[Enhancement]: Improve cover image & metadata parsed from epub ebook files #2125

Closed
opened 2026-04-25 00:03:46 +02:00 by adam · 1 comment
Owner

Originally created by @advplyr on GitHub (Jul 28, 2024).

Type of Enhancement

None

Describe the Feature/Enhancement

Select the cover image in the epub file based on the cover meta tag in the opf file. Currently the first image found in the manifest is what is being used as the cover.

Support alternative namespaces when parsing metadata from the OPF file.
Example supported:

<dc:creator opf:role="aut" opf:file-as="Orwell, George">George Orwell</dc:creator>

Example not supported alt namespace:

<dc:creator xmlns:ns0="http://www.idpf.org/2007/opf" ns0:role="aut" ns0:file-as="Steinbeck, John">John Steinbeck</dc:creator>

The same can apply when parsing the ISBN using an alt namespace:

<dc:identifier xmlns:ns4="http://www.idpf.org/2007/opf" ns4:scheme="ISBN">9781440633904</dc:identifier>

Why would this be helpful?

a

Future Implementation (Screenshot)

b

Audiobookshelf Server Version

v2.11.0

Current Implementation (Screenshot)

No response

Originally created by @advplyr on GitHub (Jul 28, 2024). ### Type of Enhancement None ### Describe the Feature/Enhancement Select the cover image in the epub file based on the cover meta tag in the opf file. Currently the first image found in the manifest is what is being used as the cover. Support alternative namespaces when parsing metadata from the OPF file. Example supported: ```xml <dc:creator opf:role="aut" opf:file-as="Orwell, George">George Orwell</dc:creator> ``` Example not supported alt namespace: ```xml <dc:creator xmlns:ns0="http://www.idpf.org/2007/opf" ns0:role="aut" ns0:file-as="Steinbeck, John">John Steinbeck</dc:creator> ``` The same can apply when parsing the ISBN using an alt namespace: ```xml <dc:identifier xmlns:ns4="http://www.idpf.org/2007/opf" ns4:scheme="ISBN">9781440633904</dc:identifier> ``` ### Why would this be helpful? a ### Future Implementation (Screenshot) b ### Audiobookshelf Server Version v2.11.0 ### Current Implementation (Screenshot) _No response_
adam added the enhancement label 2026-04-25 00:03:46 +02:00
adam closed this issue 2026-04-25 00:03:46 +02:00
Author
Owner

@github-actions[bot] commented on GitHub (Aug 5, 2024):

Fixed in v2.12.0.

@github-actions[bot] commented on GitHub (Aug 5, 2024): Fixed in [v2.12.0](https://github.com/advplyr/audiobookshelf/releases/tag/v2.12.0).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2125