[Bug]: CBZ Page Viewing Order is incorrect #3205

New issue

Open

opened 2026-02-20 11:01:26 -05:00 by deekerman · 1 comment

deekerman commented

2026-02-20 11:01:26 -05:00

Owner

Originally created by @JustinPhucHuynh on GitHub (Jan 28, 2026).

What happened?

This may be an issue of how the CBZ file was created, but for example when reading Haikyu! in the browser, the CBZ Pages In order by page number and then Chapter.

Below is an example screenshot of the contents of the CBZ File.

When reading through CBZ, it reads in the following order:

Book/Chapter01/001.jpg
Book/Chapter02/001.jpg
Book/Chapter03/001.jpg

What did you expect to happen?

When viewing CBZ File it should group the pages by the CBZ Directory and then Follow the Page Order.

For example, reading page order should be:

Book/Chapter01/001.jpg
Book/Chapter01/002.jpg
Book/Chapter01/003.jpg
...
Book/Chapter02/001.jpg
Book/Chapter02/002.jpg
Book/Chapter02/003.jpg
etc

Using AudioBooth on Mobile I can read the CBZ fine as the application will read the CBZ the pages in the correct order.

Steps to reproduce the issue

Upload a CBZ file where the contents is separated by Book/ChapterXX/page.jpg.
Read the CBZ and view the contents of the book to see what order it is in.
When reading the pages will go in order of Book/Chapter01/001.jpg, Book/Chapter02/001.jpg, Book/Chapter03/001.jpg.

Audiobookshelf version

v2.32.1

How are you running audiobookshelf?

Docker

What OS is your Audiobookshelf server hosted from?

Other (list in "Additional Notes" box)

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

Firefox

Logs

Additional Notes

Running via Docker on Truenas Scale v25.10.1

Originally created by @JustinPhucHuynh on GitHub (Jan 28, 2026). ### What happened? This may be an issue of how the CBZ file was created, but for example when reading Haikyu! in the browser, the CBZ Pages In order by page number and then Chapter. Below is an example screenshot of the contents of the CBZ File. <img width="340" height="604" alt="Image" src="https://github.com/user-attachments/assets/f477e8cc-22fb-4c3f-8a15-c5887611036e" /> When reading through CBZ, it reads in the following order: - Book/Chapter01/001.jpg - Book/Chapter02/001.jpg - Book/Chapter03/001.jpg ### What did you expect to happen? When viewing CBZ File it should group the pages by the CBZ Directory and then Follow the Page Order. For example, reading page order should be: - Book/Chapter01/001.jpg - Book/Chapter01/002.jpg - Book/Chapter01/003.jpg - ... - Book/Chapter02/001.jpg - Book/Chapter02/002.jpg - Book/Chapter02/003.jpg - etc Using AudioBooth on Mobile I can read the CBZ fine as the application will read the CBZ the pages in the correct order. ### Steps to reproduce the issue 1. Upload a CBZ file where the contents is separated by Book/ChapterXX/page.jpg. 2. Read the CBZ and view the contents of the book to see what order it is in. 3. When reading the pages will go in order of Book/Chapter01/001.jpg, Book/Chapter02/001.jpg, Book/Chapter03/001.jpg. ### Audiobookshelf version v2.32.1 ### How are you running audiobookshelf? Docker ### What OS is your Audiobookshelf server hosted from? Other (list in "Additional Notes" box) ### If the issue is being seen in the UI, what browsers are you seeing the problem on? Firefox ### Logs ```shell ``` ### Additional Notes Running via Docker on Truenas Scale v25.10.1

deekerman added the

bug

label

2026-02-20 11:01:26 -05:00

deekerman commented

2026-02-20 11:01:27 -05:00

Author

Owner

@JustinPhucHuynh commented on GitHub (Feb 4, 2026):

Looking further into the console logs the Extracted Files Object seems to be in the correct order but for some reason AudioBookShelf is sorting them into a different order.

@JustinPhucHuynh commented on GitHub (Feb 4, 2026): Looking further into the console logs the Extracted Files Object seems to be in the correct order but for some reason AudioBookShelf is sorting them into a different order. <img width="1020" height="1036" alt="Image" src="https://github.com/user-attachments/assets/2a71d8cd-6bb8-4288-be61-0705f1368511" />