[Bug]: Scan is missing several authors without errors in logs #3198

Closed
opened 2026-04-25 00:14:14 +02:00 by adam · 3 comments
Owner

Originally created by @twopiearr on GitHub (Jan 22, 2026).

What happened?

After running a Plex server for several years, I finally set up ABS in an effort to move from one platform to the other. However, when attempting to scan into a new library, many, many audiobooks are not showing up. The stats page reports 210 authors; Plex shows me 317 authors. A visual comparison shows that entire authors are just not getting picked up, but they're from all over the alphabet - AH Hadley, JRR Tolkein, and Michele Obama are all missing, for example, while the successfully imported authors run from Abby Stein all the way down to William Gibson, so it's not simply hitting a cap of authors and stopping.

What did you expect to happen?

I expected all 317 authors to be imported after the scan!

Steps to reproduce the issue

  1. Using Docker Compose, pull an image. I have tested this so far on 2.32.1 and 2.20.0 and gotten identical results.
  2. Once the image is pulled, create a new root user and a new library.
  3. Add the audiobook directory to the library.
  4. Scan the library.

Audiobookshelf version

2.32.1

How are you running audiobookshelf?

Docker

What OS is your Audiobookshelf server hosted from?

macOS

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

None

Logs

There are no error logs that I can see in the Logs window in ABS's Settings tab. I will attach the text of the logs for the scans. I have 2 logs of the scan itself, one at 387k for the initial scan and one at 58k for the follow up scan; both are too large to insert in this field, but can be provided upon request if that would be helpful.

Additional Notes

If relevant, the host is a Mac Mini with an M2 Pro CPU and 32 gigs of RAM. It is running MacOS Sequoia 15.2, and version 4.57.0 of Docker Desktop.

As noted, I have tried both versions 2.32.1 and 2.20.0 of ABS, with fully cleared config and metadata directories between each to ensure that there was no weird residual data, and got identical results. I asked on the Discord before submitting this issue, and was told that there had been "reports" from Mac users experiencing scanner issues, but I didn't see any open issues that seemed to corroborate this here on GH.

Originally created by @twopiearr on GitHub (Jan 22, 2026). ### What happened? After running a Plex server for several years, I finally set up ABS in an effort to move from one platform to the other. However, when attempting to scan into a new library, many, many audiobooks are not showing up. The stats page reports 210 authors; Plex shows me 317 authors. A visual comparison shows that entire authors are just not getting picked up, but they're from all over the alphabet - AH Hadley, JRR Tolkein, and Michele Obama are all missing, for example, while the successfully imported authors run from Abby Stein all the way down to William Gibson, so it's not simply hitting a cap of authors and stopping. ### What did you expect to happen? I expected all 317 authors to be imported after the scan! ### Steps to reproduce the issue 1. Using Docker Compose, pull an image. I have tested this so far on 2.32.1 and 2.20.0 and gotten identical results. 2. Once the image is pulled, create a new root user and a new library. 3. Add the audiobook directory to the library. 4. Scan the library. ### Audiobookshelf version 2.32.1 ### How are you running audiobookshelf? Docker ### What OS is your Audiobookshelf server hosted from? macOS ### If the issue is being seen in the UI, what browsers are you seeing the problem on? None ### Logs ```shell There are no error logs that I can see in the Logs window in ABS's Settings tab. I will attach the text of the logs for the scans. I have 2 logs of the scan itself, one at 387k for the initial scan and one at 58k for the follow up scan; both are too large to insert in this field, but can be provided upon request if that would be helpful. ``` ### Additional Notes If relevant, the host is a Mac Mini with an M2 Pro CPU and 32 gigs of RAM. It is running MacOS Sequoia 15.2, and version 4.57.0 of Docker Desktop. As noted, I have tried both versions 2.32.1 and 2.20.0 of ABS, with fully cleared config and metadata directories between each to ensure that there was no weird residual data, and got identical results. I asked on the Discord before submitting this issue, and was told that there had been "reports" from Mac users experiencing scanner issues, but I didn't see any open issues that seemed to corroborate this here on GH.
adam added the bug label 2026-04-25 00:14:14 +02:00
adam closed this issue 2026-04-25 00:14:14 +02:00
Author
Owner

@twopiearr commented on GitHub (Jan 22, 2026):

I don't seem to be able to attach the logs mentioned above.

@twopiearr commented on GitHub (Jan 22, 2026): I don't seem to be able to attach the logs mentioned above.
Author
Owner

@twopiearr commented on GitHub (Jan 25, 2026):

Experimentally I tried building a new library that added each author as a separate pathname. In so doing I think I discovered the root of the problem - ABS is simply not seeing the paths to the missing authors. See screenshots; in the macOS filesystem screenshot I have highlighted the authors that ABS is not seeing. All authors are located in the same directory of the NAS.

Image Image

This means this bug can likely be closed since it's probably not an ABS issue. That said, if anyone has any insights into how to troubleshoot this issue and could add them here, it would be greatly appreciated, since I'm certain I'm not the only one running into this issue, and it would be nice to have a reference for it.

@twopiearr commented on GitHub (Jan 25, 2026): Experimentally I tried building a new library that added each author as a separate pathname. In so doing I think I discovered the root of the problem - ABS is simply not seeing the paths to the missing authors. See screenshots; in the macOS filesystem screenshot I have highlighted the authors that ABS is not seeing. All authors are located in the same directory of the NAS. <img width="805" height="438" alt="Image" src="https://github.com/user-attachments/assets/9f675bb3-4c7e-4ea8-b60b-b18ecee7ab48" /> <img width="253" height="284" alt="Image" src="https://github.com/user-attachments/assets/d6e148e8-a9f5-47f1-91e8-5c75ea49e45e" /> This means this bug can likely be closed since it's probably not an ABS issue. That said, if anyone has any insights into how to troubleshoot this issue and could add them here, it would be greatly appreciated, since I'm certain I'm not the only one running into this issue, and it would be nice to have a reference for it.
Author
Owner

@twopiearr commented on GitHub (Jan 27, 2026):

After further troubleshooting, I was able to determine via docker exec commands that the share was seeing all the folders - it was only within ABS itself that the skips were happening. The solution appears to be: in Docker Desktop go to Settings > General. In more recent versions, VirtioFS will likely be the default file sharing implementation. Changing it to osxfs (Legacy) solved the issue and gave me all authors and books in the scan.

@twopiearr commented on GitHub (Jan 27, 2026): After further troubleshooting, I was able to determine via docker exec commands that the share was seeing all the folders - it was only within ABS itself that the skips were happening. The solution appears to be: in Docker Desktop go to Settings > General. In more recent versions, VirtioFS will likely be the default file sharing implementation. Changing it to osxfs (Legacy) solved the issue and gave me all authors and books in the scan.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3198