starred/audiobookshelf
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf.git synced 2026-05-30 23:40:40 +02:00
Code Issues 1.0k Packages Projects Releases 10 Wiki Activity

[Bug]: Automatic import doesn't reliably use Library configured metadata provider #3064

New Issue
Closed
opened 2026-04-25 00:13:22 +02:00 by adam · 8 comments
adam commented 2026-04-25 00:13:22 +02:00
Owner
Copy Link
Copy Source

Originally created by @plz12345 on GitHub (Oct 31, 2025).

What happened?

I've noticed that my newly added books are not using audible.com to fetch metadata, even though I have the library configured to use that. I can tell from two indicators

  1. The Series field isn't populated
  2. When I go back to manually match, it pulls a higher quality image for the cover

What did you expect to happen?

Use the provider I configured on the library, exclusively.

Steps to reproduce the issue

  1. Add book to directory the library is configured for
  2. Let it scan and import the book
  3. Observe result that audible.com was not used to populate the metadata

Note, this doesn't reliably fail to use the desired provider, but it happens often enough to be annoying.

Audiobookshelf version

2.30.0

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



2025-10-31 01:23:01.045 DEBUG [Watcher] File Added /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b

2025-10-31 01:23:01.045 DEBUG Watcher] Modified file in library "Audiobooks" and folder "0404a0ee-bff6-4ec8-927c-1bc8e24d7579" with relPath "/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b"

2025-10-31 01:23:01.045 DEBUG [Watcher] Waiting to add file at "/audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b". mtimeMs=1761888135591.7922 lastMTimeMs=0 (loop 0)

2025-10-31 01:23:04.046 DEBUG [Watcher] File finished adding at "/audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b"

2025-10-31 01:23:11.049 DEBUG [Scanner] scanFolderUpdates fileUpdateGroup { 'Devon C. Ford/Mission': [ 'Devon C. Ford - 2025 - Mission.m4b' ] }

2025-10-31 01:23:11.055 DEBUG [LibraryScanner] Folder update group must be a new item "Devon C. Ford/Mission" in library "Audiobooks"

2025-10-31 01:23:11.342 DEBUG [AudioFileScanner] Smart track order for "Devon C. Ford/Mission" using track key trackNumFromFilename

2025-10-31 01:23:11.342 DEBUG [Scan] "Devon C. Ford/Mission": "Mission" Getting metadata with precedence [folderStructure, audioMetatags, nfoFile, txtFiles, opfFile, absMetadata]

2025-10-31 01:23:11.343 DEBUG [Scan] "Devon C. Ford/Mission": setChapters: Using embedded chapters in first audio file /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b

2025-10-31 01:23:11.346 DEBUG [FfmpegHelpers] Extract Cover Cmd: ffmpeg -i /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b -y -map 0:v:0 -frames:v 1 /metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/cover.jpg

2025-10-31 01:23:11.523 DEBUG [Scan] "Devon C. Ford/Mission": Extracted embedded cover from audio file at "/metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/cover.jpg" for book "Mission"

2025-10-31 01:23:11.556 DEBUG [Scan] "Devon C. Ford/Mission": Success saving abmetadata to "/metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/metadata.json"

2025-10-31 01:23:11.556 DEBUG [Scan] "Devon C. Ford/Mission": Created new library item "Devon C. Ford/Mission" with id "f8a7136b-7d74-44e5-b352-fb8711cd572e"

2025-10-31 01:23:11.557 DEBUG [LibraryScanner] Folder scan results { 'Devon C. Ford/Mission': 1 }

Additional Notes

I've tried setting the provider to something else, and then changing it back.

Originally created by @plz12345 on GitHub (Oct 31, 2025). ### What happened? I've noticed that my newly added books are not using audible.com to fetch metadata, even though I have the library configured to use that. I can tell from two indicators 1. The `Series` field isn't populated 2. When I go back to manually match, it pulls a higher quality image for the cover ### What did you expect to happen? Use the provider I configured on the library, exclusively. ### Steps to reproduce the issue 1. Add book to directory the library is configured for 2. Let it scan and import the book 3. Observe result that audible.com was not used to populate the metadata Note, this doesn't reliably fail to use the desired provider, but it happens often enough to be annoying. ### Audiobookshelf version 2.30.0 ### 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 2025-10-31 01:23:01.045 DEBUG [Watcher] File Added /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b 2025-10-31 01:23:01.045 DEBUG Watcher] Modified file in library "Audiobooks" and folder "0404a0ee-bff6-4ec8-927c-1bc8e24d7579" with relPath "/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b" 2025-10-31 01:23:01.045 DEBUG [Watcher] Waiting to add file at "/audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b". mtimeMs=1761888135591.7922 lastMTimeMs=0 (loop 0) 2025-10-31 01:23:04.046 DEBUG [Watcher] File finished adding at "/audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b" 2025-10-31 01:23:11.049 DEBUG [Scanner] scanFolderUpdates fileUpdateGroup { 'Devon C. Ford/Mission': [ 'Devon C. Ford - 2025 - Mission.m4b' ] } 2025-10-31 01:23:11.055 DEBUG [LibraryScanner] Folder update group must be a new item "Devon C. Ford/Mission" in library "Audiobooks" 2025-10-31 01:23:11.342 DEBUG [AudioFileScanner] Smart track order for "Devon C. Ford/Mission" using track key trackNumFromFilename 2025-10-31 01:23:11.342 DEBUG [Scan] "Devon C. Ford/Mission": "Mission" Getting metadata with precedence [folderStructure, audioMetatags, nfoFile, txtFiles, opfFile, absMetadata] 2025-10-31 01:23:11.343 DEBUG [Scan] "Devon C. Ford/Mission": setChapters: Using embedded chapters in first audio file /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b 2025-10-31 01:23:11.346 DEBUG [FfmpegHelpers] Extract Cover Cmd: ffmpeg -i /audiobooks/Devon C. Ford/Mission/Devon C. Ford - 2025 - Mission.m4b -y -map 0:v:0 -frames:v 1 /metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/cover.jpg 2025-10-31 01:23:11.523 DEBUG [Scan] "Devon C. Ford/Mission": Extracted embedded cover from audio file at "/metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/cover.jpg" for book "Mission" 2025-10-31 01:23:11.556 DEBUG [Scan] "Devon C. Ford/Mission": Success saving abmetadata to "/metadata/items/f8a7136b-7d74-44e5-b352-fb8711cd572e/metadata.json" 2025-10-31 01:23:11.556 DEBUG [Scan] "Devon C. Ford/Mission": Created new library item "Devon C. Ford/Mission" with id "f8a7136b-7d74-44e5-b352-fb8711cd572e" 2025-10-31 01:23:11.557 DEBUG [LibraryScanner] Folder scan results { 'Devon C. Ford/Mission': 1 } ``` ### Additional Notes I've tried setting the provider to something else, and then changing it back.
adam added the bug label 2026-04-25 00:13:22 +02:00
adam closed this issue 2026-04-25 00:13:22 +02:00
adam commented 2026-04-25 00:13:22 +02:00
Author
Owner
Copy Link
Copy Source

@Vito0912 commented on GitHub (Oct 31, 2025):

If you set the logs to debug they should say which provider was used. Without this data it's hard to debug at all.

Please also check/updated your specified version as there is no 2.38.0

@Vito0912 commented on GitHub (Oct 31, 2025): If you set the logs to debug they should say which provider was used. Without this data it's hard to debug at all. Please also check/updated your specified version as there is no 2.38.0
adam commented 2026-04-25 00:13:22 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (Oct 31, 2025):

Can you clarify that you are matching against an online provider and not just scanning your file system? Scanning files in your library is fully offline and does not fetch metadata from online metadata providers. Fetching metadata from an online provider is intentionally a manual and distinct action.

@nichwall commented on GitHub (Oct 31, 2025): Can you clarify that you are matching against an online provider and not just scanning your file system? Scanning files in your library is fully offline and does not fetch metadata from online metadata providers. Fetching metadata from an online provider is intentionally a manual and distinct action.
adam commented 2026-04-25 00:13:23 +02:00
Author
Owner
Copy Link
Copy Source

@plz12345 commented on GitHub (Oct 31, 2025):

If you set the logs to debug they should say which provider was used. Without this data it's hard to debug at all.

Please also check/updated your specified version as there is no 2.38.0

Fixed. The font on numbers has styling that makes the version in the bottom left hard, from an accessibility POV. Logs also added for a recent book add, though this one did have series populated. I fail to see what provider was used.

@plz12345 commented on GitHub (Oct 31, 2025): > If you set the logs to debug they should say which provider was used. Without this data it's hard to debug at all. > > Please also check/updated your specified version as there is no 2.38.0 Fixed. The font on numbers has styling that makes the version in the bottom left hard, from an accessibility POV. Logs also added for a recent book add, though this one did have series populated. I fail to see what provider was used.
adam commented 2026-04-25 00:13:23 +02:00
Author
Owner
Copy Link
Copy Source

@plz12345 commented on GitHub (Oct 31, 2025):

Can you clarify that you are matching against an online provider and not just scanning your file system? Scanning files in your library is fully offline and does not fetch metadata from online metadata providers. Fetching metadata from an online provider is intentionally a manual and distinct action.

If it's manual and distinct, what is the point of the library setting for this?

@plz12345 commented on GitHub (Oct 31, 2025): > Can you clarify that you are matching against an online provider and not just scanning your file system? Scanning files in your library is fully offline and does not fetch metadata from online metadata providers. Fetching metadata from an online provider is intentionally a manual and distinct action. If it's manual and distinct, what is the point of the library setting for this?
adam commented 2026-04-25 00:13:23 +02:00
Author
Owner
Copy Link
Copy Source

@Vito0912 commented on GitHub (Oct 31, 2025):

I think you misunderstood what nichwall is saying. ABS will not download the metadata automatic when adding a book.

You need to quick match it yourself. Anything populated automatically is either metadata from the file itself and/or file structure.

@Vito0912 commented on GitHub (Oct 31, 2025): I think you misunderstood what nichwall is saying. ABS will not download the metadata automatic when adding a book. You need to quick match it yourself. Anything populated automatically is either metadata from the file itself and/or file structure.
adam commented 2026-04-25 00:13:24 +02:00
Author
Owner
Copy Link
Copy Source

@plz12345 commented on GitHub (Oct 31, 2025):

I think you misunderstood what nichwall is saying. ABS will not download the metadata automatic when adding a book.

You need to quick match it yourself. Anything populated automatically is either metadata from the file itself and/or file structure.

So what is the point of this setting, then?

Image
@plz12345 commented on GitHub (Oct 31, 2025): > I think you misunderstood what nichwall is saying. ABS will not download the metadata automatic when adding a book. > > You need to quick match it yourself. Anything populated automatically is either metadata from the file itself and/or file structure. So what is the point of this setting, then? <img width="774" height="240" alt="Image" src="https://github.com/user-attachments/assets/19a655cb-dc50-4805-bac0-7798393a6a56" />
adam commented 2026-04-25 00:13:24 +02:00
Author
Owner
Copy Link
Copy Source

@Vito0912 commented on GitHub (Oct 31, 2025):

For defining which provider will be used by the quick match, is default selected for other option that lets you specify the provider and the author search

@Vito0912 commented on GitHub (Oct 31, 2025): For defining which provider will be used by the quick match, is default selected for other option that lets you specify the provider and the author search
adam commented 2026-04-25 00:13:24 +02:00
Author
Owner
Copy Link
Copy Source

@plz12345 commented on GitHub (Oct 31, 2025):

For defining which provider will be used by the quick match, is default selected for other option that lets you specify the provider and the author search

Half the time, when I go into Match, it has Google Books selected by default, so I'm really confused as to the value of this setting, and a bit disappointed I can't trigger a quick match automatically when scanning. I guess "this is as designed" is my answer, though, and my issues are more on misunderstanding the design, rather than it not working.

I'll close this, either way.

@plz12345 commented on GitHub (Oct 31, 2025): > For defining which provider will be used by the quick match, is default selected for other option that lets you specify the provider and the author search Half the time, when I go into Match, it has Google Books selected by default, so I'm really confused as to the value of this setting, and a bit disappointed I can't trigger a quick match automatically when scanning. I guess "this is as designed" is my answer, though, and my issues are more on misunderstanding the design, rather than it not working. I'll close this, either way.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
authentication
backlog
bug
chapter editor
config-issue
ebooks
encoding/embedding
enhancement
help wanted
listening sessions & progress
planned
possible plugin
progress sync
pull-request
Mirrored from GitHub Pull Request
 sorting/filtering/searching
unable to reproduce
upload
users & permissions
waiting
No Label bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3064
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?