starred/audiobookshelf
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf.git synced 2026-05-30 23:40:40 +02:00
Code Issues 1.0k Packages Projects Releases 10 Wiki Activity

[Bug]: Some epubs fail to load the correct cover #2650

New Issue
Closed
opened 2026-04-25 00:09:19 +02:00 by adam · 1 comment
adam commented 2026-04-25 00:09:19 +02:00
Owner
Copy Link
Copy Source

Originally created by @Roukanken42 on GitHub (Mar 11, 2025).

What happened?

Some epubs show different covers when loaded in ABS as when instead using other tools (like for example Calibre). Even changing the cover in Calibre and exporting from there, won't fix the ABS import.

One example of such book is here (Taken from Epub samples). When loaded in ABS it'll look like this:
Image

When loaded by Calibre:
Image

What did you expect to happen?

I expected to have the same cover in ABS as it had in Calibre.

Steps to reproduce the issue

  1. Upload the specific epub to ABS
  2. Look at wrong cover

Audiobookshelf version

v2.19.5

How are you running audiobookshelf?

Docker

What OS is your Audiobookshelf server hosted from?

Linux

If the issue is being seen in the UI, what browsers are you seeing the problem on?

Firefox

Logs

Additional Notes

The issue comes from missing cover metadata entry, as the epub instead uses cover-image property in manifest to specify the correct image.

Originally created by @Roukanken42 on GitHub (Mar 11, 2025). ### What happened? Some epubs show different covers when loaded in ABS as when instead using other tools (like for example Calibre). Even changing the cover in Calibre and exporting from there, won't fix the ABS import. One example of such book is [here](https://github.com/IDPF/epub3-samples/releases/download/20230704/epub30-spec.epub) (Taken from [Epub samples](https://idpf.github.io/epub3-samples/30/samples.html)). When loaded in ABS it'll look like this: ![Image](https://github.com/user-attachments/assets/4f498bf9-8a78-4fe4-b5b3-88a8ab433432) When loaded by Calibre: ![Image](https://github.com/user-attachments/assets/00f9b769-52af-4c2f-85a1-16a42991a09e) ### What did you expect to happen? I expected to have the same cover in ABS as it had in Calibre. ### Steps to reproduce the issue 1. Upload the specific epub to ABS 2. Look at wrong cover ### Audiobookshelf version v2.19.5 ### How are you running audiobookshelf? Docker ### What OS is your Audiobookshelf server hosted from? Linux ### If the issue is being seen in the UI, what browsers are you seeing the problem on? Firefox ### Logs ```shell ``` ### Additional Notes The issue comes from missing cover metadata entry, as the epub instead uses [cover-image property](https://www.w3.org/TR/epub-33/#sec-cover-image) in manifest to specify the correct image.
adam added the bug label 2026-04-25 00:09:19 +02:00
adam closed this issue 2026-04-25 00:09:19 +02:00
adam commented 2026-04-25 00:09:19 +02:00
Author
Owner
Copy Link
Copy Source

@github-actions[bot] commented on GitHub (Mar 17, 2025):

Fixed in v2.20.0.

@github-actions[bot] commented on GitHub (Mar 17, 2025): Fixed in [v2.20.0](https://github.com/advplyr/audiobookshelf/releases/tag/v2.20.0).
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
authentication
backlog
bug
chapter editor
config-issue
ebooks
encoding/embedding
enhancement
help wanted
listening sessions & progress
planned
possible plugin
progress sync
pull-request
Mirrored from GitHub Pull Request
 sorting/filtering/searching
unable to reproduce
upload
users & permissions
waiting
No Label bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2650
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?