[Bug]: Uploaded a book but it's not showing up #3215

Open
opened 2026-04-25 00:14:20 +02:00 by adam · 4 comments
Owner

Originally created by @silviubajenaru on GitHub (Feb 3, 2026).

What happened?

I have uploaded a book from an author, the library gets scanned and I get the message below:

Scanning file changes in "Audiobooks"
1 updated (10 sec)

One would think, "Great, I can start listening to this". Well, the thing is, the book's not in the Library. I can see it under /audiobooks/<author>/<book name> and inside that path there's the m4b, a pdf and a jpg file. So it looks good.
What I tried:

  1. Rescanning the library - no luck
  2. Trying to reupload - but I get the error saying that the filepath already exists - which is correct
  3. Manually deleting the folder /audiobooks/<author> and reupload it - no luck
  4. Changing the name of the author (even by just adding a 1 at the end of the name makes it show up in the library
  5. I have deleted the Author name from the upload field and this made it work. Still, I want this to be saved correctly, under the correct path.The logs don't show anything useful. To be honest, the logs are completely empty so .... ?
  6. Try from a different browser - no luck

P.S. I've uploaded multiple books and they all seem to work, except this one. Still, I don't think it's an issue with the book, since if I don't specify the Author's name, all is well.

What did you expect to happen?

I expected the book to show up in Library

Steps to reproduce the issue

To be honest, I have no clue. I did nothing special, just uploaded stuff.

Audiobookshelf version

ghcr.io/advplyr/audiobookshelf:2.32.1

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?

None

Logs


Additional Notes

No response

Originally created by @silviubajenaru on GitHub (Feb 3, 2026). ### What happened? I have uploaded a book from an author, the library gets scanned and I get the message below: ``` Scanning file changes in "Audiobooks" 1 updated (10 sec) ``` One would think, "Great, I can start listening to this". Well, the thing is, the book's not in the Library. I can see it under `/audiobooks/<author>/<book name>` and inside that path there's the m4b, a pdf and a jpg file. So it looks good. What I tried: 1. Rescanning the library - no luck 2. Trying to reupload - but I get the error saying that the `filepath already exists` - which is correct 3. Manually deleting the folder `/audiobooks/<author>` and reupload it - no luck 4. Changing the name of the author (even by just adding a `1` at the end of the name makes it show up in the library 5. I have deleted the Author name from the upload field and this made it work. Still, I want this to be saved correctly, under the correct path.The logs don't show anything useful. To be honest, the logs are completely empty so .... ? 6. Try from a different browser - no luck P.S. I've uploaded multiple books and they all seem to work, except this one. Still, I don't think it's an issue with the book, since if I don't specify the Author's name, all is well. ### What did you expect to happen? I expected the book to show up in Library ### Steps to reproduce the issue To be honest, I have no clue. I did nothing special, just uploaded stuff. ### Audiobookshelf version ghcr.io/advplyr/audiobookshelf:2.32.1 ### 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? None ### Logs ```shell ``` ### Additional Notes _No response_
adam added the bug label 2026-04-25 00:14:20 +02:00
Author
Owner

@Vito0912 commented on GitHub (Feb 3, 2026):

Can you please provide the scan logs. The scanner should create an extra log (unless you already checked this).

Also please provide a tree of the directory. In many cases the directory structure is the cause for this. You have to have each book in it's own folder.

The audiobooks/<author>/ is not allowed to contain a file, just folders of books.

@Vito0912 commented on GitHub (Feb 3, 2026): Can you please provide the scan logs. The scanner should create an extra log (unless you already checked this). Also please provide a tree of the directory. In many cases the directory structure is the cause for this. You have to have each book in it's own folder. The `audiobooks/<author>/` is not allowed to contain a file, just folders of books.
Author
Owner

@silviubajenaru commented on GitHub (Feb 3, 2026):

Somehow, the scan logs are empty:

# ls -la metadata/logs/scans/
total 8
drwxr-xr-x 2 root root 4096 Feb  3 12:16 .
drwxr-xr-x 4 root root 4096 Feb  3 07:32 ..

As for the folder structure, I get you, it's correct.

One would think, "Great, I can start listening to this". Well, the thing is, the book's not in the Library. I can see it under /audiobooks// and inside that path there's the m4b, a pdf and a jpg file. So it looks good.

So the book was actually there, but it was not showing up. Weirdly enough it's fixed by:

  1. Stopping the container
  2. Deleting the author from /audiobooks/
  3. Starting the app
  4. Reuploading
    Now I can see the book just fine. Still no scan logs though.... Any clue why that could be?
@silviubajenaru commented on GitHub (Feb 3, 2026): Somehow, the scan logs are empty: ``` # ls -la metadata/logs/scans/ total 8 drwxr-xr-x 2 root root 4096 Feb 3 12:16 . drwxr-xr-x 4 root root 4096 Feb 3 07:32 .. ``` As for the folder structure, I get you, it's correct. > One would think, "Great, I can start listening to this". Well, the thing is, the book's not in the Library. I can see it under /audiobooks/<author>/<book name> and inside that path there's the m4b, a pdf and a jpg file. So it looks good. So the book was actually there, but it was not showing up. Weirdly enough it's fixed by: 1. Stopping the container 2. Deleting the author from `/audiobooks/` 3. Starting the app 4. Reuploading Now I can see the book just fine. Still no scan logs though.... Any clue why that could be?
Author
Owner

@Gernomaly commented on GitHub (Feb 13, 2026):

I have had similar issues.
I found out that my issues could be solved by deleting metadata files, that some of these audiobooks had within their folder.

I have to point out that after that all books showed up that didn't show up before, EVEN Books that didn't have metadata within their folder in the first place.

@Gernomaly commented on GitHub (Feb 13, 2026): I have had similar issues. I found out that my issues could be solved by deleting metadata files, that some of these audiobooks had within their folder. I have to point out that after that all books showed up that didn't show up before, EVEN Books that didn't have metadata within their folder in the first place.
Author
Owner

@milligaa-coder commented on GitHub (Mar 2, 2026):

I had this same issue. The cause of the issue for me ended up being book 8 in the series when pulled in for some reason named the folder what should have been book 9. However in ABS the meta data was correct for book 8 so it showed with the correct title and cover so I didn't notice. When I tried to upload book 9 it said already exists, which I thought was odd since I hadn't loaded it so I deleted the folder and reloaded it. However even though all the data on the upload screen was correct it was pulling the old meta data for book 8 show showing up as book 8. I manually changed the title by using search and finding book 9, then reuploaded book 8 and made sure it named the folder correctly and this fixed the problem.

@milligaa-coder commented on GitHub (Mar 2, 2026): I had this same issue. The cause of the issue for me ended up being book 8 in the series when pulled in for some reason named the folder what should have been book 9. However in ABS the meta data was correct for book 8 so it showed with the correct title and cover so I didn't notice. When I tried to upload book 9 it said already exists, which I thought was odd since I hadn't loaded it so I deleted the folder and reloaded it. However even though all the data on the upload screen was correct it was pulling the old meta data for book 8 show showing up as book 8. I manually changed the title by using search and finding book 9, then reuploaded book 8 and made sure it named the folder correctly and this fixed the problem.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3215