mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2026-05-30 23:40:40 +02:00
[Enhancement]: Series detection should not depend on file structure #3183
Assignees
adam (Adam Melkus)
Clear assignees
adam (Adam Melkus)
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/audiobookshelf#3183
Reference in New Issue
Block a user
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?
Originally created by @Afisher21 on GitHub (Jan 11, 2026).
Type of Enhancement
Server Backend
Describe the Feature/Enhancement
When scanning new books, the scanner correctly identifies the title and description of the book, but fails to set the series tag information, unless it is in a specific folder structure.
Why would this be helpful?
Allows for less effort in ingesting new libraries, especially when contributors may not all adhere to strict folder structure guidelines.
Future Implementation (Screenshot)
Audiobookshelf Server Version
2.32.1
Current Implementation (Screenshot)
@Vito0912 commented on GitHub (Jan 11, 2026):
You can disable that ABS uses the file structure in the settings. Additional to that it does not depend on the file structure. There are other ways to read the series, such as file metadata and metadata.json files.
Please see https://www.audiobookshelf.org/docs/#book-audio-metadata for the tags ABS supports, which includes series.
@Afisher21 commented on GitHub (Jan 12, 2026):
@Vito0912 Thanks for the info, I didn't realize how much metadata was embedded alongside the audio tracks :). I used 'exiftool' to look at the two m4b files in question to see why one was recognized and the other wasn't. It turns out one of the extracted media actually had the 'Series' details and the one that didn't lacked this info. Even using the 'Match books' option under the library scan options fails to populate the 'Series' metadata, so I think there is still value here in the ask. I am unable to open a PR, so I've attached a proposed patch if this is something agreed upon to do.
Otherwise I'll just write a tool to embed the Series metadata outside of ABS and then just have ABS rescan.
GetSeriesInfo.patch.txt
@nichwall commented on GitHub (Jan 12, 2026):
This fetches metadata against an online metadata provider, so this requires your selected provider to have series metadata for the book and that the matched book is correct.
@Afisher21 commented on GitHub (Jan 12, 2026):
Nice! Confirmed that switching metadata provider from default "Google Books" to "Audible.com" successfully identifies the series information. Is it worth calling out in a note in the Readme that the default metadata provider doesn't include series info?