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

Open
opened 2026-02-20 11:01:30 -05:00 by deekerman · 3 comments
Owner

Originally created by @hac3ru 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 @hac3ru 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_
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

@hac3ru 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?
@hac3ru 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 12, 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 12, 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.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/audiobookshelf-advplyr#3216
No description provided.