[Bug]: Loading an EPUB EBOOK with a Table of Contents causes online reader to jump all over the place #2407

New issue

Open

opened 2026-02-20 10:18:59 -05:00 by deekerman · 2 comments

deekerman commented

2026-02-20 10:18:59 -05:00

Owner

Originally created by @kjloo on GitHub (Dec 8, 2024).

What happened?

I loaded an epub ebook and tried to read it in the browser and app readers and I can't get past the table of contents. If I click links in the table of contents it goes to incorrect places. If I try to just read through, it keeps resetting to the beginning.

What did you expect to happen?

I expected to be able to read the book without it automatically skipping around (I don't even click anything and it resets to the beginning).

Steps to reproduce the issue

Load an EPUB with table of contents
Try to read using the app or browser
Reader skips around

Audiobookshelf version

v2.17.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?

Chrome

Logs

No response

Additional Notes

No response

Originally created by @kjloo on GitHub (Dec 8, 2024). ### What happened? I loaded an epub ebook and tried to read it in the browser and app readers and I can't get past the table of contents. If I click links in the table of contents it goes to incorrect places. If I try to just read through, it keeps resetting to the beginning. ### What did you expect to happen? I expected to be able to read the book without it automatically skipping around (I don't even click anything and it resets to the beginning). ### Steps to reproduce the issue 1. Load an EPUB with table of contents 2. Try to read using the app or browser 3. Reader skips around ### Audiobookshelf version v2.17.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? Chrome ### Logs _No response_ ### Additional Notes _No response_

deekerman added the

bug

ebooks

labels

2026-02-20 10:18:59 -05:00

deekerman commented

2026-02-20 10:19:00 -05:00

Author

Owner

@nichwall commented on GitHub (Dec 8, 2024):

This is usually caused by issues with the epub file. Can you try doing an epub to epub conversion in Calibre to see if that fixes it?

@nichwall commented on GitHub (Dec 8, 2024): This is usually caused by issues with the epub file. Can you try doing an epub to epub conversion in Calibre to see if that fixes it?

deekerman commented

2026-02-20 10:19:00 -05:00

Author

Owner

@kjloo commented on GitHub (Dec 15, 2024):

Works. The kindle played it no problem without converting it.

@kjloo commented on GitHub (Dec 15, 2024): Works. The kindle played it no problem without converting it.