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]: Series Sequence Issue #2785

New Issue
Open
opened 2026-04-25 00:10:39 +02:00 by adam · 6 comments
adam commented 2026-04-25 00:10:39 +02:00
Owner
Copy Link
Copy Source

Originally created by @GinSoakedBoy on GitHub (May 19, 2025).

What happened?

Adding something other than just a number to a series Sequence causes ABS to change the series.

For example The Uriel Ventris Chronicles One and Two are both a collection of novels and short stories. Goodreads has them listed in the Ultramarines Series as "BOOK 1-3 + SHORT STORIES" and "BOOK 4-6 + SHORT STORIES".

ABS changes the series to "Ultramarines #1-3 & short stories" and "Ultramarines #4-6 & short stories"

Image

What did you expect to happen?

Ideally the series would be "Ultramarines"with the sequence being "1-3 & short stories" and "4-6 & short stories".

Steps to reproduce the issue

  1. Change the "Sequence" of a book within a Series to something with multiple words e.g. Short Story

Audiobookshelf version

v2.23.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

Running in a Portainer docker container on a TrueNAS server.

Originally created by @GinSoakedBoy on GitHub (May 19, 2025). ### What happened? Adding something other than just a number to a series Sequence causes ABS to change the series. For example The Uriel Ventris Chronicles One and Two are both a collection of novels and short stories. Goodreads has them listed in the Ultramarines Series as "BOOK 1-3 + SHORT STORIES" and "BOOK 4-6 + SHORT STORIES". ABS changes the series to "Ultramarines #1-3 & short stories" and "Ultramarines #4-6 & short stories" <img width="513" alt="Image" src="https://github.com/user-attachments/assets/ca254899-dbd7-4e6c-aa2c-6cf8df9f088a" /> ### What did you expect to happen? Ideally the series would be "Ultramarines"with the sequence being "1-3 & short stories" and "4-6 & short stories". ### Steps to reproduce the issue 1. Change the "Sequence" of a book within a Series to something with multiple words e.g. Short Story ### Audiobookshelf version v2.23.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 ```shell ``` ### Additional Notes Running in a Portainer docker container on a TrueNAS server.
adam added the bug label 2026-04-25 00:10:39 +02:00
adam commented 2026-04-25 00:10:40 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (May 19, 2025):

How was this set? Importing from the file system, manually setting it in the UI, or matching against an online provider?

@nichwall commented on GitHub (May 19, 2025): How was this set? Importing from the file system, manually setting it in the UI, or matching against an online provider?
adam commented 2026-04-25 00:10:40 +02:00
Author
Owner
Copy Link
Copy Source

@GinSoakedBoy commented on GitHub (May 19, 2025):

Setting manually within the UI, and matching with GoodReads using abs-tract.

@GinSoakedBoy commented on GitHub (May 19, 2025): Setting manually within the UI, and matching with GoodReads using [abs-tract](https://github.com/ahobsonsayers/abs-tract).
adam commented 2026-04-25 00:10:40 +02:00
Author
Owner
Copy Link
Copy Source

@Vito0912 commented on GitHub (May 19, 2025):

I somewhat experienced the same behaviour.

I am not sure what caused it, because I am not sure when I noticed it, but I think enconding an item with a series with multiple words leads to the exact same behaviour (but not tested, but same symptoms)

@Vito0912 commented on GitHub (May 19, 2025): I somewhat experienced the same behaviour. I am not sure what caused it, because I am not sure when I noticed it, but I think enconding an item with a series with multiple words leads to the exact same behaviour (but not tested, but same symptoms)
adam commented 2026-04-25 00:10:40 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (May 20, 2025):

This is because you are storing json metadata with the item and those series are saved as "Series name #1".

  "series": [
    "Test #1-3 & short stories"
  ],

Then those get parsed here:
https://github.com/advplyr/audiobookshelf/blob/077273033657da2345494084dc7a1f399cc1a7ba/server/utils/parsers/parseSeriesString.js#L1-L27

There is an open bug report for this already I'm pretty sure.

That json should just be updated to store an object instead of a string

@advplyr commented on GitHub (May 20, 2025): This is because you are storing json metadata with the item and those series are saved as "Series name #1". ```json "series": [ "Test #1-3 & short stories" ], ``` Then those get parsed here: https://github.com/advplyr/audiobookshelf/blob/077273033657da2345494084dc7a1f399cc1a7ba/server/utils/parsers/parseSeriesString.js#L1-L27 There is an open bug report for this already I'm pretty sure. That json should just be updated to store an object instead of a string
adam commented 2026-04-25 00:10:40 +02:00
Author
Owner
Copy Link
Copy Source

@GinSoakedBoy commented on GitHub (May 20, 2025):

Is this something that can be fixed, or do we need to avoid spaces in series sequences?

@GinSoakedBoy commented on GitHub (May 20, 2025): Is this something that can be fixed, or do we need to avoid spaces in series sequences?
adam commented 2026-04-25 00:10:41 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (May 20, 2025):

Is this something that can be fixed, or do we need to avoid spaces in series sequences?

It would probably be best to just avoid spaces in series sequences. Currently the series sequence is a string (so can contain numbers and letters), but the hope is to eventually only support numbers so SQL queries are easier to handle. Unfortunately, a lot of users were already using alphanumeric series sequence (such as 1.a) before Audiobookshelf migrated to SQLite.

@nichwall commented on GitHub (May 20, 2025): > Is this something that can be fixed, or do we need to avoid spaces in series sequences? It would probably be best to just avoid spaces in series sequences. Currently the series sequence is a string (so can contain numbers and letters), but the hope is to eventually only support numbers so SQL queries are easier to handle. Unfortunately, a lot of users were already using alphanumeric series sequence (such as `1.a`) before Audiobookshelf migrated to SQLite.
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#2785
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?