[Bug]: Genres including commas are sometimes treating the comma as a seperator #587

Closed
opened 2026-04-24 23:13:56 +02:00 by adam · 3 comments
Owner

Originally created by @chyron8472 on GitHub (Aug 18, 2022).

Describe the issue

image

I edited some of my books in ABS to assign them the genres "Fantasy, High" and "Fantasy, Low" so that they would be listed under "Fantasy" in the list of genres. However, sometimes I'm finding items having separate "Fantasy" and "High" genres instead.

Steps to reproduce the issue

  1. Tag a book with a genre that includes a comma
  2. ???

Audiobookshelf version

v2.1.2

How are you running audiobookshelf?

Docker

Originally created by @chyron8472 on GitHub (Aug 18, 2022). ### Describe the issue ![image](https://user-images.githubusercontent.com/12549803/185455641-41525fd7-a4ce-4b70-957f-815c519b7ff4.png) I edited some of my books in ABS to assign them the genres "Fantasy, High" and "Fantasy, Low" so that they would be listed under "Fantasy" in the list of genres. However, sometimes I'm finding items having separate "Fantasy" and "High" genres instead. ### Steps to reproduce the issue 1. Tag a book with a genre that includes a comma 2. ??? ### Audiobookshelf version v2.1.2 ### How are you running audiobookshelf? Docker
adam added the bug label 2026-04-24 23:13:56 +02:00
adam closed this issue 2026-04-24 23:13:56 +02:00
Author
Owner

@advplyr commented on GitHub (Aug 19, 2022):

This is a problem because of how the metadata.abs file is saving and parsing the genres.
The metadata.abs is storing genres as comma separated then when it gets re-scanned it will treat Fantasy and Low separately.

I guess it makes sense now why the genre ID3 tag uses ; / and // as separators instead of commas.

@advplyr commented on GitHub (Aug 19, 2022): This is a problem because of how the metadata.abs file is saving and parsing the genres. The metadata.abs is storing genres as comma separated then when it gets re-scanned it will treat Fantasy and Low separately. I guess it makes sense now why the genre ID3 tag uses `;` `/` and `//` as separators instead of commas.
Author
Owner

@pkhanpara commented on GitHub (Feb 19, 2023):

how do we fix this without breaking backward compatibility to read old metadata.abs?

@pkhanpara commented on GitHub (Feb 19, 2023): how do we fix this without breaking backward compatibility to read old metadata.abs?
Author
Owner

@advplyr commented on GitHub (May 28, 2023):

In v2.2.21 I added an option to choose metadata.json instead of metadata.abs. For all new installs this will be the default, but for existing installs you will need to switch this over.
Once you switch over to JSON and press edit then save on a library item it will replace the metadata.abs with a metadata.json.

This will resolve these issues with commas.

@advplyr commented on GitHub (May 28, 2023): In [v2.2.21](https://github.com/advplyr/audiobookshelf/releases/tag/v2.2.21) I added an option to choose metadata.json instead of metadata.abs. For all new installs this will be the default, but for existing installs you will need to switch this over. Once you switch over to JSON and press edit then save on a library item it will replace the metadata.abs with a metadata.json. This will resolve these issues with commas.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#587