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/Enhancement]: For series detection by id3 tags, use GRP1 in addition to/instead of TXXX:grouping #2397

New Issue
Closed
opened 2026-04-25 00:06:44 +02:00 by adam · 5 comments
adam commented 2026-04-25 00:06:44 +02:00
Owner
Copy Link
Copy Source

Originally created by @Cantello on GitHub (Dec 5, 2024).

What happened?

According to this comment the grouping tag is used to define series. However, when using abs to embed metadata into mp3 files, it writes the obsolete TXXX:grouping field, instead of the widely accepted GRP1 field, which is used by major id3 taggers (kid3, mp3tag, MusicBrainz Picard) and I cannot edit the tags anymore outside of abs, which kind of defeats the purpose of standardised tags.

What did you expect to happen?

Adiobookshelf recognizes the GRP1 tag when detecting metadata.

Steps to reproduce the issue

  1. Edit series in audiobookshelf
  2. Embed metadata into mp3 files
  3. Try editing with an id3 tagger

Audiobookshelf version

2.17.3

How are you running audiobookshelf?

Docker

What OS is your Audiobookshelf server hosted from?

Linux

If the issue is being seen in the UI, what browsers are you seeing the problem on?

Firefox

Logs

No response

Additional Notes

According to https://github.com/advplyr/audiobookshelf/blob/c03f18b90a100ab0041f05993700d3404f88c9dc/server/utils/prober.js#L192 the grouping tag is only defined by one property, whereas e.g. Album is defined as file_tag_album: tryGrabTags(format, 'album', 'talb', 'tal'),, Artist as file_tag_artist: tryGrabTags(format, 'artist', 'tpe1', 'tp1'),.
Could the definition of grouping be expanded similarly to file_tag_grouping: tryGrabTags(format, 'grouping', 'grp1'),?

Originally created by @Cantello on GitHub (Dec 5, 2024). ### What happened? According to [this comment](https://github.com/advplyr/audiobookshelf/issues/3547#issuecomment-2440086269) the `grouping` tag is used to define series. However, when using abs to embed metadata into mp3 files, it writes the obsolete `TXXX:grouping` field, instead of the widely accepted `GRP1` field, which is used by major id3 taggers (kid3, mp3tag, MusicBrainz Picard) and I cannot edit the tags anymore outside of abs, which kind of defeats the purpose of standardised tags. ### What did you expect to happen? Adiobookshelf recognizes the `GRP1` tag when detecting metadata. ### Steps to reproduce the issue 1. Edit series in audiobookshelf 2. Embed metadata into mp3 files 3. Try editing with an id3 tagger ### Audiobookshelf version 2.17.3 ### How are you running audiobookshelf? Docker ### What OS is your Audiobookshelf server hosted from? Linux ### If the issue is being seen in the UI, what browsers are you seeing the problem on? Firefox ### Logs _No response_ ### Additional Notes According to https://github.com/advplyr/audiobookshelf/blob/c03f18b90a100ab0041f05993700d3404f88c9dc/server/utils/prober.js#L192 the `grouping` tag is only defined by one property, whereas e.g. Album is defined as `file_tag_album: tryGrabTags(format, 'album', 'talb', 'tal'),`, Artist as `file_tag_artist: tryGrabTags(format, 'artist', 'tpe1', 'tp1'),`. Could the definition of grouping be expanded similarly to `file_tag_grouping: tryGrabTags(format, 'grouping', 'grp1'),`?
adam added the bug label 2026-04-25 00:06:44 +02:00
adam closed this issue 2026-04-25 00:06:44 +02:00
adam commented 2026-04-25 00:06:44 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Dec 5, 2024):

Does ffprobe detect that tag? https://www.audiobookshelf.org/guides/ffprobe/#inspecting-an-audio-file

@advplyr commented on GitHub (Dec 5, 2024): Does ffprobe detect that tag? https://www.audiobookshelf.org/guides/ffprobe/#inspecting-an-audio-file
adam commented 2026-04-25 00:06:44 +02:00
Author
Owner
Copy Link
Copy Source

@Cantello commented on GitHub (Dec 5, 2024):

Does ffprobe detect that tag? https://www.audiobookshelf.org/guides/ffprobe/#inspecting-an-audio-file

Yes, it does (output of ffprobe on a file with the GRP1 tag written):

  [...]
      "title": "Kapitel 1 & Kapitel 2.1 - Tintenwelt 1. Tintenherz",
      "track": "1/63",
      "GRP1": "Tintenwelt",
      "date": "2013-08-01"
  [...]
@Cantello commented on GitHub (Dec 5, 2024): > Does ffprobe detect that tag? https://www.audiobookshelf.org/guides/ffprobe/#inspecting-an-audio-file Yes, it does (output of ffprobe on a file with the GRP1 tag written): ``` [...] "title": "Kapitel 1 & Kapitel 2.1 - Tintenwelt 1. Tintenherz", "track": "1/63", "GRP1": "Tintenwelt", "date": "2013-08-01" [...] ```
adam commented 2026-04-25 00:06:45 +02:00
Author
Owner
Copy Link
Copy Source

@github-actions[bot] commented on GitHub (Dec 6, 2024):

Fixed in v2.17.4.

@github-actions[bot] commented on GitHub (Dec 6, 2024): Fixed in [v2.17.4](https://github.com/advplyr/audiobookshelf/releases/tag/v2.17.4).
adam commented 2026-04-25 00:06:45 +02:00
Author
Owner
Copy Link
Copy Source

@Cantello commented on GitHub (Dec 6, 2024):

Tested and it works, great, thanks!

@Cantello commented on GitHub (Dec 6, 2024): Tested and it works, great, thanks!
adam commented 2026-04-25 00:06:45 +02:00
Author
Owner
Copy Link
Copy Source

@Cantello commented on GitHub (Jun 17, 2025):

Did anything change since the last release? I checked and the only grouping tag that was recognized by abs was a TXXX frame with 'grouping' as the description. Whenever I try to tag something with Yate (Mac tagger comparable to mp3tag), the GRP1 tag (encoded in UTF16) was not recognized. Can provide samples if necessary.

@Cantello commented on GitHub (Jun 17, 2025): Did anything change since the last release? I checked and the only grouping tag that was recognized by abs was a TXXX frame with 'grouping' as the description. Whenever I try to tag something with Yate (Mac tagger comparable to mp3tag), the GRP1 tag (encoded in UTF16) was not recognized. Can provide samples if necessary.
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#2397
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?