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]: Metadata Folder Structure Scanner Error for Series that go beyond 999 #3253

New Issue
Open
opened 2026-04-25 00:14:32 +02:00 by adam · 1 comment
adam commented 2026-04-25 00:14:32 +02:00
Owner
Copy Link
Copy Source

Originally created by @JustinPhucHuynh on GitHub (Mar 4, 2026).

What happened?

Example Directory Structure:
/Author/Series/1 - 2000 - Title 1
...
/Author/Series/999 - 2023 - Title 999
...
/Author/Series/1045 - 2026 - Title 1045

When the series sequence goes beyond 999, metadata parsing is inconsistent. Sometimes the Series will have the sequence number and sometimes it will not. The Year also seems to be mapped to title.

For example metadata.json:
"title": "2025",
"subtitle": "Title 1045",
"series": ["Series"],
"publishedYear": "1045"

What did you expect to happen?

Sequence, year, title should be parsed to the correct fields in metadata.json.

"title": "Title 1045",
"subtitle": null,
"series": ["Series #1045"],
"publishedYear": "2025"

Steps to reproduce the issue

  1. Library Settings for Scanner
  2. Set as 1 Audiobookshelf metadata file
  3. Set as 2 Folder Structure
  4. Disable the rest of metadata order of precedence.
  5. Create a directory "/Test/A Test/1456 - 2026 - Test, 1456"
  6. Copy any book file into the directory
  7. Initiate scan and check metadata.json

Json automatically produced:
{ "tags": [], "chapters": [], "title": "2026", "subtitle": "Test, 1456", "authors": [ "Test" ], "narrators": [], "series": [ "A Test" ], "genres": [], "publishedYear": "1456", "publishedDate": null, "publisher": null, "description": null, "isbn": null, "asin": null, "language": null, "explicit": false, "abridged": false }

Audiobookshelf version

v2.32.1

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

2026-03-04 10:47:30.889

DEBUG

[Scanner] scanFolderUpdates fileUpdateGroup { 'Test/A Test/1456 - 2026 - Test, 1456': [ 'test.cbz' ] }

2026-03-04 10:47:30.915

DEBUG

[LibraryScanner] Folder update group must be a new item "Test/A Test/1456 - 2026 - Test, 1456" in library "Books"

2026-03-04 10:47:30.915

DEBUG

[parseComicMetadata] Parsing comic metadata at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.916

DEBUG

[CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.916

DEBUG

[CbzStreamZipComicBookExtractor] Found 13 files in comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.916

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": "2026" Getting metadata with precedence [folderStructure, absMetadata]

2026-03-04 10:47:30.916

DEBUG

[CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.917

DEBUG

[CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.921

DEBUG

[CbzStreamZipComicBookExtractor] Extracted file "1171-001.png" from comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" to "/metadata/items/916462a8-3534-4529-9328-909b47364588/cover.png"

2026-03-04 10:47:30.921

DEBUG

[CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:30.923

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": Extracted embedded cover from ebook file at "/metadata/items/916462a8-3534-4529-9328-909b47364588/cover.png" for book "2026"

2026-03-04 10:47:30.972

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": Success saving abmetadata to "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json"

2026-03-04 10:47:30.975

DEBUG

[ApiCacheManager] libraryItem.afterUpdate: Clearing cache

2026-03-04 10:47:30.975

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": Created new library item "Test/A Test/1456 - 2026 - Test, 1456" with id "916462a8-3534-4529-9328-909b47364588"

2026-03-04 10:47:30.976

DEBUG

[LibraryScanner] Folder scan results { 'Test/A Test/1456 - 2026 - Test, 1456': 1 }

2026-03-04 10:47:31.101

DEBUG

[ApiCacheManager] count: 0 size: 0

2026-03-04 10:47:31.593

DEBUG

[ApiCacheManager] Cache miss: {"user":"JbGy1SV9FqbgdMnVF2uAeud6H8XmpPQxh0EGGq2QNYkGq6zG8XNV9xdQ7upwPsWY","url":"/libraries/b2238b74-3033-49d1-b9c8-0eff64a7b58b/series?sort=name&desc=0&filter=all&limit=24&page=0&minified=1&include=rssfeed,numEpisodesIncomplete,share"}

2026-03-04 10:47:33.602

DEBUG

[Watcher] File Added /mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json

2026-03-04 10:47:33.602

DEBUG

[Watcher] Modified file in library "Books" and folder "3c34d11f-5299-45d6-9011-15d0812da23d" with relPath "/Test/A Test/1456 - 2026 - Test, 1456/metadata.json"

2026-03-04 10:47:33.604

DEBUG

[Watcher] Waiting to add file at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json". mtimeMs=1772650050967.6162 lastMTimeMs=0 (loop 0)

2026-03-04 10:47:36.606

DEBUG

[Watcher] File finished adding at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json"

2026-03-04 10:47:43.610

DEBUG

[Scanner] scanFolderUpdates fileUpdateGroup { 'Test/A Test/1456 - 2026 - Test, 1456': [ 'metadata.json' ] }

2026-03-04 10:47:43.643

DEBUG

[LibraryScanner] Folder update for relative path "Test/A Test/1456 - 2026 - Test, 1456" is in library item "2026" with id "916462a8-3534-4529-9328-909b47364588" - scan for updates

2026-03-04 10:47:43.665

DEBUG

[parseComicMetadata] Parsing comic metadata at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:43.665

DEBUG

[CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:43.666

DEBUG

[CbzStreamZipComicBookExtractor] Found 13 files in comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:43.666

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": "2026" Getting metadata with precedence [folderStructure, absMetadata]

2026-03-04 10:47:43.666

DEBUG

[CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz"

2026-03-04 10:47:43.667

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": Found metadata file "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json"

2026-03-04 10:47:43.667

DEBUG

[Scan] "Test/A Test/1456 - 2026 - Test, 1456": Library item is up-to-date

2026-03-04 10:47:43.667

DEBUG

[LibraryScanner] Folder scan results { 'Test/A Test/1456 - 2026 - Test, 1456': 4 }

Additional Notes

Truenas Scale v25.10.1

Originally created by @JustinPhucHuynh on GitHub (Mar 4, 2026). ### What happened? Example Directory Structure: /Author/Series/1 - 2000 - Title 1 ... /Author/Series/999 - 2023 - Title 999 ... /Author/Series/1045 - 2026 - Title 1045 When the series sequence goes beyond 999, metadata parsing is inconsistent. Sometimes the Series will have the sequence number and sometimes it will not. The Year also seems to be mapped to title. For example metadata.json: "title": "2025", "subtitle": "Title 1045", "series": ["Series"], "publishedYear": "1045" ### What did you expect to happen? Sequence, year, title should be parsed to the correct fields in metadata.json. "title": "Title 1045", "subtitle": null, "series": ["Series #1045"], "publishedYear": "2025" ### Steps to reproduce the issue 1. Library Settings for Scanner 2. Set as 1 Audiobookshelf metadata file 3. Set as 2 Folder Structure 4. Disable the rest of metadata order of precedence. 5. Create a directory "/Test/A Test/1456 - 2026 - Test, 1456" 6. Copy any book file into the directory 7. Initiate scan and check metadata.json Json automatically produced: `{ "tags": [], "chapters": [], "title": "2026", "subtitle": "Test, 1456", "authors": [ "Test" ], "narrators": [], "series": [ "A Test" ], "genres": [], "publishedYear": "1456", "publishedDate": null, "publisher": null, "description": null, "isbn": null, "asin": null, "language": null, "explicit": false, "abridged": false }` ### Audiobookshelf version v2.32.1 ### 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 ```shell 2026-03-04 10:47:30.889 DEBUG [Scanner] scanFolderUpdates fileUpdateGroup { 'Test/A Test/1456 - 2026 - Test, 1456': [ 'test.cbz' ] } 2026-03-04 10:47:30.915 DEBUG [LibraryScanner] Folder update group must be a new item "Test/A Test/1456 - 2026 - Test, 1456" in library "Books" 2026-03-04 10:47:30.915 DEBUG [parseComicMetadata] Parsing comic metadata at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.916 DEBUG [CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.916 DEBUG [CbzStreamZipComicBookExtractor] Found 13 files in comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.916 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": "2026" Getting metadata with precedence [folderStructure, absMetadata] 2026-03-04 10:47:30.916 DEBUG [CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.917 DEBUG [CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.921 DEBUG [CbzStreamZipComicBookExtractor] Extracted file "1171-001.png" from comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" to "/metadata/items/916462a8-3534-4529-9328-909b47364588/cover.png" 2026-03-04 10:47:30.921 DEBUG [CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:30.923 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": Extracted embedded cover from ebook file at "/metadata/items/916462a8-3534-4529-9328-909b47364588/cover.png" for book "2026" 2026-03-04 10:47:30.972 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": Success saving abmetadata to "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json" 2026-03-04 10:47:30.975 DEBUG [ApiCacheManager] libraryItem.afterUpdate: Clearing cache 2026-03-04 10:47:30.975 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": Created new library item "Test/A Test/1456 - 2026 - Test, 1456" with id "916462a8-3534-4529-9328-909b47364588" 2026-03-04 10:47:30.976 DEBUG [LibraryScanner] Folder scan results { 'Test/A Test/1456 - 2026 - Test, 1456': 1 } 2026-03-04 10:47:31.101 DEBUG [ApiCacheManager] count: 0 size: 0 2026-03-04 10:47:31.593 DEBUG [ApiCacheManager] Cache miss: {"user":"JbGy1SV9FqbgdMnVF2uAeud6H8XmpPQxh0EGGq2QNYkGq6zG8XNV9xdQ7upwPsWY","url":"/libraries/b2238b74-3033-49d1-b9c8-0eff64a7b58b/series?sort=name&desc=0&filter=all&limit=24&page=0&minified=1&include=rssfeed,numEpisodesIncomplete,share"} 2026-03-04 10:47:33.602 DEBUG [Watcher] File Added /mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json 2026-03-04 10:47:33.602 DEBUG [Watcher] Modified file in library "Books" and folder "3c34d11f-5299-45d6-9011-15d0812da23d" with relPath "/Test/A Test/1456 - 2026 - Test, 1456/metadata.json" 2026-03-04 10:47:33.604 DEBUG [Watcher] Waiting to add file at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json". mtimeMs=1772650050967.6162 lastMTimeMs=0 (loop 0) 2026-03-04 10:47:36.606 DEBUG [Watcher] File finished adding at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json" 2026-03-04 10:47:43.610 DEBUG [Scanner] scanFolderUpdates fileUpdateGroup { 'Test/A Test/1456 - 2026 - Test, 1456': [ 'metadata.json' ] } 2026-03-04 10:47:43.643 DEBUG [LibraryScanner] Folder update for relative path "Test/A Test/1456 - 2026 - Test, 1456" is in library item "2026" with id "916462a8-3534-4529-9328-909b47364588" - scan for updates 2026-03-04 10:47:43.665 DEBUG [parseComicMetadata] Parsing comic metadata at "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:43.665 DEBUG [CbzStreamZipComicBookExtractor] Opened comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:43.666 DEBUG [CbzStreamZipComicBookExtractor] Found 13 files in comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:43.666 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": "2026" Getting metadata with precedence [folderStructure, absMetadata] 2026-03-04 10:47:43.666 DEBUG [CbzStreamZipComicBookExtractor] Closed comic book "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/test.cbz" 2026-03-04 10:47:43.667 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": Found metadata file "/mnt/internal_hdd_18tb_pool/Media/Manga/Test/A Test/1456 - 2026 - Test, 1456/metadata.json" 2026-03-04 10:47:43.667 DEBUG [Scan] "Test/A Test/1456 - 2026 - Test, 1456": Library item is up-to-date 2026-03-04 10:47:43.667 DEBUG [LibraryScanner] Folder scan results { 'Test/A Test/1456 - 2026 - Test, 1456': 4 } ``` ### Additional Notes Truenas Scale v25.10.1
adam added the bug label 2026-04-25 00:14:32 +02:00
adam commented 2026-04-25 00:14:32 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (Mar 4, 2026):

Duplicate of https://github.com/advplyr/audiobookshelf/issues/4781

@nichwall commented on GitHub (Mar 4, 2026): Duplicate of https://github.com/advplyr/audiobookshelf/issues/4781
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#3253
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?