[Bug]: Not possible to upload more than one ebook - all epub-files are stored in the same folder #2966

Closed
opened 2026-04-25 00:12:29 +02:00 by adam · 18 comments
Owner

Originally created by @Cotignac on GitHub (Aug 22, 2025).

What happened?

When I'm trying to import more than one ebook by either dropping the epub file on the web browser window or manually selecting them only ONE LINE/ITEM is displayed in the browser.

Then after the import and re-scanning the library one new book/item is visible. However, when I checked the folder where the epub file and json file are stored I can see that all the epub files I tried to import are saved.

When I have tried the same thing with audio books stored as MP3 files and that works perfectly (as before).

I have to say that I have created one library for the ebooks and another for the audio books. They are saved in different folders on the same Synology NAS.

What did you expect to happen?

I expected (as in previous versions) that one folder for each ebook should be created and that after the upload and re-scanning of the library I should see the same amount of new ebooks as the number of files I have uploaded.

Steps to reproduce the issue

  1. Select Upload on a library containing only ebooks.
  2. Drag and drop more than one epub file to the web browser window.
  3. Start the upload and look into the folder for ebooks and you'll see that all epub files are stored in the folder for the first ebook.

Audiobookshelf version

2.28.0

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?

Edge

Logs

2025-08-22 18:37:31.289

INFO

Uploading 3 files to /ebooks/9789189688278

Additional Notes

I'm running audiobookshelf on a Synology using DSM 7.1.1-42962 Update 9

Originally created by @Cotignac on GitHub (Aug 22, 2025). ### What happened? When I'm trying to import more than one ebook by either dropping the epub file on the web browser window or manually selecting them only ONE LINE/ITEM is displayed in the browser. Then after the import and re-scanning the library one new book/item is visible. However, when I checked the folder where the epub file and json file are stored I can see that all the epub files I tried to import are saved. When I have tried the same thing with audio books stored as MP3 files and that works perfectly (as before). I have to say that I have created one library for the ebooks and another for the audio books. They are saved in different folders on the same Synology NAS. ### What did you expect to happen? I expected (as in previous versions) that one folder for each ebook should be created and that after the upload and re-scanning of the library I should see the same amount of new ebooks as the number of files I have uploaded. ### Steps to reproduce the issue 1. Select Upload on a library containing only ebooks. 2. Drag and drop more than one epub file to the web browser window. 3. Start the upload and look into the folder for ebooks and you'll see that all epub files are stored in the folder for the first ebook. ### Audiobookshelf version 2.28.0 ### 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? Edge ### Logs ```shell 2025-08-22 18:37:31.289 INFO Uploading 3 files to /ebooks/9789189688278 ``` ### Additional Notes I'm running audiobookshelf on a Synology using DSM 7.1.1-42962 Update 9
adam added the bug label 2026-04-25 00:12:29 +02:00
adam closed this issue 2026-04-25 00:12:29 +02:00
Author
Owner

@Vito0912 commented on GitHub (Aug 22, 2025):

Can you please provide a tree of that directory and parent directory?

@Vito0912 commented on GitHub (Aug 22, 2025): Can you please provide a tree of that directory and parent directory?
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

Image
@Cotignac commented on GitHub (Aug 22, 2025): <img width="336" height="547" alt="Image" src="https://github.com/user-attachments/assets/846bfb3c-e452-4a1c-864c-9100ae476136" />
Author
Owner

@Vito0912 commented on GitHub (Aug 22, 2025):

And the other books are not listed under "Ebook Files"? (Note that you only can have one primary book per item)

@Vito0912 commented on GitHub (Aug 22, 2025): And the other books are not listed under "Ebook Files"? (Note that you only can have one primary book per item)
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

That's how I discovered it. They are visible as E-book files on the only book that was imported/created.
But why are the books not imported as separate books - like they were before?

@Cotignac commented on GitHub (Aug 22, 2025): That's how I discovered it. They are visible as E-book files on the only book that was imported/created. But why are the books not imported as separate books - like they were before?
Author
Owner

@nichwall commented on GitHub (Aug 22, 2025):

Every book must be in its own folder. Multiple books in the same folder is not supported.

@nichwall commented on GitHub (Aug 22, 2025): Every book must be in its own folder. Multiple books in the same folder is not supported.
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

Yes I know. But I've been doing this import many times before with no problem. Is this a change that has been done as a new feature? And in that case - why are not audio books treated in the same way?

@Cotignac commented on GitHub (Aug 22, 2025): Yes I know. But I've been doing this import many times before with no problem. Is this a change that has been done as a new feature? And in that case - why are not audio books treated in the same way?
Author
Owner

@Vito0912 commented on GitHub (Aug 22, 2025):

Audiobooks are treated the same way. One folder is one item

TL;DR This is not a bug but intended behaviour

Edit: Ah, so you are talking about the upload process. Sorry my bad.
Did you made sure that you did not upload a folder but the epub files ?
While uploading it should display the folder it is uploading to

Edit2: Ok for books they are automatically grouped. I am not sure if that is a bug though ? @nichwall ?

@Vito0912 commented on GitHub (Aug 22, 2025): ~~Audiobooks are treated the same way. One folder is one item~~ ~~TL;DR This is not a bug but intended behaviour~~ Edit: Ah, so you are talking about the upload process. Sorry my bad. Did you made sure that you did not upload a folder but the epub files ? While uploading it should display the folder it is uploading to Edit2: Ok for books they are automatically grouped. I am not sure if that is a bug though ? @nichwall ?
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

I'm picking the epub files from one folder and dropping it on the browser window. Then I can see only one item/line in the browser. I can also see the text "1 object" above the line with the first of the epub files.

or...

I'm clicking on the button "Choose files" and browse to the folder with my epub files. Select two of them and when I'm returning to the browser I can see the text "1 object", the name of the first epub file and also the directory with the same name as the epub file.

So my question is: Why do you have a feature that makes it possible to upload more than one ebook if it's not supposed to add all ebooks that was imported as separate books?

You can call it whatever you like but it's definitively something that has been changed recently. If it's not a bug, what is it?

@Cotignac commented on GitHub (Aug 22, 2025): I'm picking the epub files from one folder and dropping it on the browser window. Then I can see only one item/line in the browser. I can also see the text "1 object" above the line with the first of the epub files. or... I'm clicking on the button "Choose files" and browse to the folder with my epub files. Select two of them and when I'm returning to the browser I can see the text "1 object", the name of the first epub file and also the directory with the same name as the epub file. So my question is: Why do you have a feature that makes it possible to upload more than one ebook if it's not supposed to add all ebooks that was imported as separate books? You can call it whatever you like but it's definitively something that has been changed recently. If it's not a bug, what is it?
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

If this is a feature and not a bug. Please let me know how I can upload more than one epub file and after the scanning see them as separate items/books in audiobookshelf?

@Cotignac commented on GitHub (Aug 22, 2025): If this is a feature and not a bug. Please let me know how I can upload more than one epub file and after the scanning see them as separate items/books in audiobookshelf?
Author
Owner

@Vito0912 commented on GitHub (Aug 22, 2025):

Please let me know how I can upload more than one epub file and after the scanning see them as separate items/books in audiobookshelf?

Uploading them individually as far as I understand it currently

@advplyr I am not sure if that is a bug or not (That books are grouped together as one item)?

You can call it whatever you like but it's definitively something that has been changed recently. If it's not a bug, what is it?

Are you sure that changed? The code for this does not seem to have been updated in a while.

@Vito0912 commented on GitHub (Aug 22, 2025): > Please let me know how I can upload more than one epub file and after the scanning see them as separate items/books in audiobookshelf? Uploading them individually as far as I understand it currently @advplyr I am not sure if that is a bug or not (That books are grouped together as one item)? > You can call it whatever you like but it's definitively something that has been changed recently. If it's not a bug, what is it? Are you sure that changed? The code for this does not seem to have been updated in a while.
Author
Owner

@nichwall commented on GitHub (Aug 22, 2025):

I'll need to look at it more later since I'm not understanding exactly what is happening and would need to sit down and understand all of the steps.

So my question is: Why do you have a feature that makes it possible to upload more than one ebook if it's not supposed to add all ebooks that was imported as separate books?

You can add multiple ebook files to a single book for supplementary material (such as maps, other references, etc). This was the original intention of ebook support in ABS, tracking progress in a single ebook file per library item was added later.

@nichwall commented on GitHub (Aug 22, 2025): I'll need to look at it more later since I'm not understanding exactly what is happening and would need to sit down and understand all of the steps. > So my question is: Why do you have a feature that makes it possible to upload more than one ebook if it's not supposed to add all ebooks that was imported as separate books? You can add multiple ebook files to a single book for supplementary material (such as maps, other references, etc). This was the original intention of ebook support in ABS, tracking progress in a single ebook file per library item was added later.
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

Yes I'm sure it has changed. The only thing I have changed is the name of the epub files. Before I named them by the name of the book. Now I'm using the IBAN-number of the book.

Before when I uploaded more than one epub file they were displayed as separated lines/items in the browser window before i started the upload.

Don't you have a setup using an old version that you can try this on?

@Cotignac commented on GitHub (Aug 22, 2025): Yes I'm sure it has changed. The only thing I have changed is the name of the epub files. Before I named them by the name of the book. Now I'm using the IBAN-number of the book. Before when I uploaded more than one epub file they were displayed as separated lines/items in the browser window before i started the upload. Don't you have a setup using an old version that you can try this on?
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

I can see if I can setup a second installation on another Synology with an old version and see how it works there...

@Cotignac commented on GitHub (Aug 22, 2025): I can see if I can setup a second installation on another Synology with an old version and see how it works there...
Author
Owner

@Vito0912 commented on GitHub (Aug 22, 2025):

Yes I'm sure it has changed.

Then you remeber wrongly. I just tried a year old version. And as expected from the code, this was the case all the way (at least) a year old version. Probably always.

efore I named them by the name of the book. Now I'm using the IBAN-number of the book.

You probably mean the ISBN, but ABS always pulled the name from the filename. As your files are named like the ISBN it's named like an ISBN as expected too.

As nichwall mentioned this was mostly designed so you can pull in a audiobook with the book as one item. I agree that it is not very intuitive that if you only select "books" that it groups them to one book, but tbf it only states audiobook files:

. If uploading only audio files then each audio file will be handled as a separate audiobook.

@Vito0912 commented on GitHub (Aug 22, 2025): > Yes I'm sure it has changed. Then you remeber wrongly. I just tried a year old version. And as expected from the code, this was the case all the way (at least) a year old version. Probably always. > efore I named them by the name of the book. Now I'm using the IBAN-number of the book. You probably mean the ISBN, but ABS always pulled the name from the filename. As your files are named like the ISBN it's named like an ISBN as expected too. As nichwall mentioned this was mostly designed so you can pull in a audiobook with the book as one item. I agree that it is not very intuitive that if you only select "books" that it groups them to one book, but tbf it only states audiobook files: > . If uploading only audio files then each audio file will be handled as a separate audiobook.
Author
Owner

@nichwall commented on GitHub (Aug 22, 2025):

Yeah, if you can provide a specific version number of when this functionality was different that would be really helpful so we have more of an idea of when/where to look for changes.

@nichwall commented on GitHub (Aug 22, 2025): Yeah, if you can provide a specific version number of when this functionality was different that would be really helpful so we have more of an idea of when/where to look for changes.
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

I'm sitting here in the south of France thinking with a glass of wine in my hand...
You might be right - and I'm wrong (it has happened before) ;-)

In an old issues that I added in February (#4049) I wrote that I'm using Calibre for my ebooks and downloading metadata in Calibre before importing it to audiobookshelf. That means that Calibre is creating one folder for each book, adding the epub file in that folder and creating an opf file for each book with the metadata. Then the opf file is used by audiobookshelf to create the json file. Unfortunately this is not made correctly (#4049).

This week I've added storytel-provider to my setup that makes it possible for me to download the metadata in audiobookshelf directly from Storytel. By doing this I don't need Calibre and therefore I started to import the epub files directly to audiobookshelf and that's when I discovered this "bug".

My bad. I'm really sorry for taking up your time and being so stubborn. 1000 times sorry from me.

But, wouldn't it be a good idea to have the option to choose if the files you're uploading should be handled as separated books or as one item?

@Cotignac commented on GitHub (Aug 22, 2025): I'm sitting here in the south of France thinking with a glass of wine in my hand... You might be right - and I'm wrong (it has happened before) ;-) In an old issues that I added in February (#4049) I wrote that I'm using Calibre for my ebooks and downloading metadata in Calibre before importing it to audiobookshelf. That means that Calibre is creating one folder for each book, adding the epub file in that folder and creating an opf file for each book with the metadata. Then the opf file is used by audiobookshelf to create the json file. Unfortunately this is not made correctly (#4049). This week I've added storytel-provider to my setup that makes it possible for me to download the metadata in audiobookshelf directly from Storytel. By doing this I don't need Calibre and therefore I started to import the epub files directly to audiobookshelf and that's when I discovered this "bug". My bad. I'm really sorry for taking up your time and being so stubborn. 1000 times sorry from me. But, wouldn't it be a good idea to have the option to choose if the files you're uploading should be handled as separated books or as one item?
Author
Owner

@Cotignac commented on GitHub (Aug 22, 2025):

Close issue

@Cotignac commented on GitHub (Aug 22, 2025): Close issue
Author
Owner

@advplyr commented on GitHub (Aug 23, 2025):

There is a close button that you can use but I'll get it

@advplyr commented on GitHub (Aug 23, 2025): There is a close button that you can use but I'll get it
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2966