[Bug]: Cannot open downloaded epub files #1000

Open
opened 2026-04-24 23:45:22 +02:00 by adam · 9 comments
Owner

Originally created by @jveronese on GitHub (Jul 27, 2024).

What was the Problem?

When I download an ebook (epub format is most of my library, including the current file I'm using) and I open the book, it just gives me a blank screen. When I delete the local item, I can read the book from the server. The issue happens on both my Android tablet and my iPhone (app installed through TestFlight).

Steps to Reproduce the Issue

  1. Go to ebook library
  2. Select book
  3. Download for offline reading
  4. Open book. The screen is blank until I go back to the main book page and delete the local item.

What was Expected?

To read the book the same way as if I stream the epub from the server

Phone Model

iPhone 15 Max/ Meebook M6

Phone OS

iPhone 18 beta (happened on iOS 17 as well)/Android 11

Audiobookshelf App Version

Android App - 0.9.74

Installation Source

Google Play Store

Additional Notes

I have tried on my Meedbook Android tablet, my iPhone, and my iPad Pro 11 (M2 on ios 17). All have the same result.

On checking ABS logs I am seeing an error when I download a book

[LibraryItemController]
Library file "bunch-of-numbers" does not exist for library item
Originally created by @jveronese on GitHub (Jul 27, 2024). ### What was the Problem? When I download an ebook (epub format is most of my library, including the current file I'm using) and I open the book, it just gives me a blank screen. When I delete the local item, I can read the book from the server. The issue happens on both my Android tablet and my iPhone (app installed through TestFlight). ### Steps to Reproduce the Issue 1. Go to ebook library 2. Select book 3. Download for offline reading 4. Open book. The screen is blank until I go back to the main book page and delete the local item. ### What was Expected? To read the book the same way as if I stream the epub from the server ### Phone Model iPhone 15 Max/ Meebook M6 ### Phone OS iPhone 18 beta (happened on iOS 17 as well)/Android 11 ### Audiobookshelf App Version Android App - 0.9.74 ### Installation Source Google Play Store ### Additional Notes I have tried on my Meedbook Android tablet, my iPhone, and my iPad Pro 11 (M2 on ios 17). All have the same result. On checking ABS logs I am seeing an error when I download a book ``` [LibraryItemController] Library file "bunch-of-numbers" does not exist for library item ```
adam added the bugiOS labels 2026-04-24 23:45:22 +02:00
Author
Owner

@nichwall commented on GitHub (Jul 27, 2024):

Is this true for all epub files, or only certain books?

Can you try scanning the library item again on the server? I'm not sure why it would work while connected to the server, but could be a permissions issue or something got moved around.

Screenshot_20240727-080912.png

@nichwall commented on GitHub (Jul 27, 2024): Is this true for all epub files, or only certain books? Can you try scanning the library item again on the server? I'm not sure why it would work while connected to the server, but could be a permissions issue or something got moved around. ![Screenshot_20240727-080912.png](https://github.com/user-attachments/assets/7dbea268-cca8-4d29-8c7f-ce634a193a2b)
Author
Owner

@jveronese commented on GitHub (Jul 27, 2024):

Thanks! A manual re-scan fixed it. I don't know why it popped up after a manual scan though, I have ABS scheduled to scan that library every 15 minutes so I know it's been scanned since I've been having the issue.

Maybe just to many updates in between a manual scan.

@jveronese commented on GitHub (Jul 27, 2024): Thanks! A manual re-scan fixed it. I don't know why it popped up after a manual scan though, I have ABS scheduled to scan that library every 15 minutes so I know it's been scanned since I've been having the issue. Maybe just to many updates in between a manual scan.
Author
Owner

@nichwall commented on GitHub (Jul 27, 2024):

If it stops working again later, there is probably something messed up in the database from moving files around or having a media file in a higher level directory.

Glad you got it figured out

@nichwall commented on GitHub (Jul 27, 2024): If it stops working again later, there is probably something messed up in the database from moving files around or having a media file in a higher level directory. Glad you got it figured out
Author
Owner

@SmackleFunky commented on GitHub (Aug 9, 2024):

This happens to me every time I do a local download, if I have both the ebook and audiobook. The audiobook will play, but the ebook will not show (It shows a blank page and Table of Contents is empty). If I have just an ebook it works fine.

Re-Scan does not fix.

@SmackleFunky commented on GitHub (Aug 9, 2024): This happens to me every time I do a local download, if I have both the ebook and audiobook. The audiobook will play, but the ebook will not show (It shows a blank page and Table of Contents is empty). If I have just an ebook it works fine. Re-Scan does not fix.
Author
Owner

@nichwall commented on GitHub (Aug 10, 2024):

This may be a problem with specific ebook files. What file formats are you ebooks?

Do the ebooks load correctly when connected to the server?
If epub, can you try doing an epub -> epub conversion using Calibre or another tool to make sure those specific epubs are not malformed?

@nichwall commented on GitHub (Aug 10, 2024): This may be a problem with specific ebook files. What file formats are you ebooks? Do the ebooks load correctly when connected to the server? If epub, can you try doing an epub -> epub conversion using Calibre or another tool to make sure those specific epubs are not malformed?
Author
Owner

@SmackleFunky commented on GitHub (Aug 10, 2024):

Ok you are right, I had some sample biases, it is just some epub files don't work locally.

doing an epub->epub conversion seems to have fixed the issue with the ones I was working with.

@SmackleFunky commented on GitHub (Aug 10, 2024): Ok you are right, I had some sample biases, it is just some epub files don't work locally. doing an epub->epub conversion seems to have fixed the issue with the ones I was working with.
Author
Owner

@nichwall commented on GitHub (Aug 10, 2024):

Yeah, many epub files are weird/don't confirm to spec (even from publishers), so running epub files through a more robust converter like Calibre will fix a lot of epub issues for ABS and other programs. ABS doesn't do any ebook conversions, but may eventually handle some more simple cases.

@nichwall commented on GitHub (Aug 10, 2024): Yeah, many epub files are weird/don't confirm to spec (even from publishers), so running epub files through a more robust converter like Calibre will fix a lot of epub issues for ABS and other programs. ABS doesn't do any ebook conversions, but may eventually handle some more simple cases.
Author
Owner

@amphyvi commented on GitHub (Feb 19, 2025):

I'm somehow having the opposite problem. Books open fine via the web client both on desktop & mobile sites... and on the mobile app, I can download a book and read it anytime.

But, if I try reading a book on the mobile app without pressing the download button first, it's blank 100% of the time for every single book. The Table of Contents even says "no chapters", as if it's corrupt or something. I can't figure out what the issue could be.

@amphyvi commented on GitHub (Feb 19, 2025): I'm somehow having the opposite problem. Books open fine via the web client both on desktop & mobile sites... and on the mobile app, I can download a book and read it anytime. But, if I try reading a book on the mobile app without pressing the download button first, it's blank 100% of the time for every single book. The Table of Contents even says "no chapters", as if it's corrupt or something. I can't figure out what the issue could be.
Author
Owner

@maanisim commented on GitHub (Apr 5, 2025):

I don't think the app supports reading books, do note this is an epub book but I am also seeing 'no chapters' and UI looks as if it tries to listen to it

Image

@maanisim commented on GitHub (Apr 5, 2025): I don't think the app supports reading books, do note this is an epub book but I am also seeing 'no chapters' and UI looks as if it tries to listen to it ![Image](https://github.com/user-attachments/assets/5401d0d6-2e65-428e-9a40-ba12f5f89d66)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf-app#1000