mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2026-05-30 23:40:40 +02:00
[Bug]: Cannot auto-import series numbers above 999 #3058
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#3058
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 @jrobelen on GitHub (Oct 29, 2025).
What happened?
In a folder import, if series number is 1000 or higher (i.e., four or more digits), the given series number will populate the year field.
What did you expect to happen?
I expect the series number part of the folder name to always populate the series number field regardless of the number.
Steps to reproduce the issue
Audiobookshelf version
v2.30.0
How are you running audiobookshelf?
Docker
What OS is your Audiobookshelf server hosted from?
Other (list in "Additional Notes" box)
If the issue is being seen in the UI, what browsers are you seeing the problem on?
None
Logs
Additional Notes
@nichwall commented on GitHub (Oct 29, 2025):
I think this is behaving as expected because a 4 digit number at the beginning of the folder name is parsed as a year. If you want a 4 digit number to be parsed as the series sequence, you can use
Vol #### - Titleformat as described in the documentation.https://www.audiobookshelf.org/docs#book-title-folder-naming
@jrobelen commented on GitHub (Oct 29, 2025):
Sorry, I haven't found in the documentation where says it will interpret 4-digit numerals as years.
But I have again tried all sorts of variations as instructed, and no matter what format I put the series number, with or without a year in the folder name, it either reads it in as a year or (if the year appears first) just ignores it, if it is 1000 or higher.
@nichwall commented on GitHub (Oct 29, 2025):
From the docs:
It doesn't specifically say that a 4 digit number is a year, but most series don't have more than 1000 entries and this overlaps with the publish year definition. I see you mentioned this is due to radio dramas, but I think those can fit as a podcast library better. Podcast support is still not great in ABS as the priority is audiobooks, but it does exist for serial publications like this.
If you want the number to be parsed as the series sequence you will need to add the descriptor so the parser can recognize it as a sequence. Each folder is scanned in isolation, so there is not logic to recognize there are 1000 other folders that follow the same pattern in the folder (and even if there was this extra logic, some people just throw everything in the same folder so this check would also handle those edge cases).
Edit to add: for clarification, have you tried something like
The Two Light Zone/Two Light Zone Radio Dramas/Vol 1602 - A Passage For Trumpet": "A Passage For Trumpet"?@jrobelen commented on GitHub (Oct 29, 2025):
Yes, I tried prefixing "Vol", "Vol.", "#" and "Book" to the folder name, with and without a year descriptor, and the scanner scooped the whole thing up as one title. If the year was at the beginning of the folder name, it was assigned to the year field and the remainder of the name was used as the title.