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

[Enhancement]: Use ID3 Title tag for chapter name when prefer audio metadata #424

New Issue
Closed
opened 2026-04-24 23:08:30 +02:00 by adam · 11 comments
adam commented 2026-04-24 23:08:30 +02:00
Owner
Copy Link
Copy Source

Originally created by @SenorSmartyPants on GitHub (Jun 4, 2022).

Describe the issue

When metadata is preferred chapter names should be imported from ID3 title field. Currently filename is used as chapter title, even if metadata is preferred and title field is present.

Steps to reproduce the issue

My files are named in this format, with track number and then track title.
01 - Intro
02 - Chapter 1
etc

Audiobookshelf version

2.0.18

How are you running audiobookshelf?

Docker

Originally created by @SenorSmartyPants on GitHub (Jun 4, 2022). ### Describe the issue When metadata is preferred chapter names should be imported from ID3 title field. Currently filename is used as chapter title, even if metadata is preferred and title field is present. ### Steps to reproduce the issue My files are named in this format, with track number and then track title. 01 - Intro 02 - Chapter 1 etc ### Audiobookshelf version 2.0.18 ### How are you running audiobookshelf? Docker
adam added the enhancement label 2026-04-24 23:08:30 +02:00
adam closed this issue 2026-04-24 23:08:33 +02:00
adam commented 2026-04-24 23:08:33 +02:00
Author
Owner
Copy Link
Copy Source

@SenorSmartyPants commented on GitHub (Nov 7, 2022):

Any updates to this now that ABS is using tone?

@SenorSmartyPants commented on GitHub (Nov 7, 2022): Any updates to this now that ABS is using tone?
adam commented 2026-04-24 23:08:35 +02:00
Author
Owner
Copy Link
Copy Source

@QantumEntangled commented on GitHub (Feb 11, 2023):

Came here for the same issue.

Version 2.2.14 in Docker

Spent hours editing ID3 tags to make them pretty, but the filenames are long and gross.

@QantumEntangled commented on GitHub (Feb 11, 2023): Came here for the same issue. Version 2.2.14 in Docker Spent hours editing ID3 tags to make them pretty, but the filenames are long and gross.
adam commented 2026-04-24 23:08:35 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Mar 13, 2023):

I'm confused on this implementation. Currently the album or the title id3 tag is used as book title.
If this were set then all the chapters would have the same name. I'm not sure what you were intending here.

@advplyr commented on GitHub (Mar 13, 2023): I'm confused on this implementation. Currently the album or the title id3 tag is used as book title. If this were set then all the chapters would have the same name. I'm not sure what you were intending here.
adam commented 2026-04-24 23:08:35 +02:00
Author
Owner
Copy Link
Copy Source

@SenorSmartyPants commented on GitHub (Mar 13, 2023):

Book title in ABS is fine. Just a problem with track/chapter titles.

Here's part of ffprobe of some files affected.

Input #0, mp3, from '01 - Opening Credits.mp3':
  Metadata:
    title           : Opening Credits
    artist          : Blake Crouch
    track           : 1/17
    album           : Dark Matter

Input #0, mp3, from '02 - Chapter 1.mp3':
  Metadata:
    title           : Chapter 1
    artist          : Blake Crouch
    track           : 2/17
    album           : Dark Matter

Gets imported into ABS like this.
image

It has been a while since I imported these, so if I should reimport/rescan just let me know how you would like me to do that and I'll try it out.

I follow the Seanap guidelines for tagging.

@SenorSmartyPants commented on GitHub (Mar 13, 2023): Book title in ABS is fine. Just a problem with track/chapter titles. Here's part of ffprobe of some files affected. ``` Input #0, mp3, from '01 - Opening Credits.mp3': Metadata: title : Opening Credits artist : Blake Crouch track : 1/17 album : Dark Matter ``` ``` Input #0, mp3, from '02 - Chapter 1.mp3': Metadata: title : Chapter 1 artist : Blake Crouch track : 2/17 album : Dark Matter ``` Gets imported into ABS like this. ![image](https://user-images.githubusercontent.com/991618/224849472-479ac012-f2eb-4fbb-8a66-b44aa8ccf664.png) It has been a while since I imported these, so if I should reimport/rescan just let me know how you would like me to do that and I'll try it out. I follow the Seanap guidelines for tagging.
adam commented 2026-04-24 23:08:36 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Mar 13, 2023):

Ok I put this in for next release. The only criteria is that the title tag should not be the same as the book title. The reason for this is because in the docs we also support using the title tag as your book title.

@advplyr commented on GitHub (Mar 13, 2023): Ok I put this in for next release. The only criteria is that the title tag should not be the same as the book title. The reason for this is because in the docs we also support using the title tag as your book title.
adam commented 2026-04-24 23:08:37 +02:00
Author
Owner
Copy Link
Copy Source

@SenorSmartyPants commented on GitHub (Mar 13, 2023):

Sounds great. Thank you! Would doing a book rescan be the way to update these fields for me then?

@SenorSmartyPants commented on GitHub (Mar 13, 2023): Sounds great. Thank you! Would doing a book rescan be the way to update these fields for me then?
adam commented 2026-04-24 23:08:37 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Mar 14, 2023):

Unfortunately not. The chapters won't get rebuilt unless an audio track changes. You could press Manage Tracks and change the order of a track, press save, then change the order back.

@advplyr commented on GitHub (Mar 14, 2023): Unfortunately not. The chapters won't get rebuilt unless an audio track changes. You could press Manage Tracks and change the order of a track, press save, then change the order back.
adam commented 2026-04-24 23:08:38 +02:00
Author
Owner
Copy Link
Copy Source

@Demian98 commented on GitHub (Mar 14, 2023):

This would be a great feature and very useful for me. @advplyr if the ID3 title can be used as chapter, the embed metadata feature should also write the chapter as ID3 title. Because currently all information can be stored into the mp3 with the embed metadata feature, expect of the chapters. It would be great if this would be change too :)

@Demian98 commented on GitHub (Mar 14, 2023): This would be a great feature and very useful for me. @advplyr if the ID3 title can be used as chapter, the embed metadata feature should also write the chapter as ID3 title. Because currently all information can be stored into the mp3 with the embed metadata feature, expect of the chapters. It would be great if this would be change too :)
adam commented 2026-04-24 23:08:39 +02:00
Author
Owner
Copy Link
Copy Source

@hobesman commented on GitHub (Mar 18, 2023):

This would be a great feature and very useful for me. @advplyr if the ID3 title can be used as chapter, the embed metadata feature should also write the chapter as ID3 title. Because currently all information can be stored into the mp3 with the embed metadata feature, expect of the chapters. It would be great if this would be change too :)

I agree it would be cool to embed chapter as track title, but the problem is, this assumes each file is one chapter. But often mp3 files are divided into ~1 hour segments, not chapters.

Also, some mp3 files are the entire book in one file, so no way to embed each chapter title.

@hobesman commented on GitHub (Mar 18, 2023): > This would be a great feature and very useful for me. @advplyr if the ID3 title can be used as chapter, the embed metadata feature should also write the chapter as ID3 title. Because currently all information can be stored into the mp3 with the embed metadata feature, expect of the chapters. It would be great if this would be change too :) I agree it would be cool to embed chapter as track title, but the problem is, this assumes each file is one chapter. But often mp3 files are divided into ~1 hour segments, not chapters. Also, some mp3 files are the entire book in one file, so no way to embed each chapter title.
adam commented 2026-04-24 23:08:40 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Mar 19, 2023):

Updated in v2.2.17

@advplyr commented on GitHub (Mar 19, 2023): Updated in [v2.2.17](https://github.com/advplyr/audiobookshelf/releases/tag/v2.2.17)
adam commented 2026-04-24 23:08:41 +02:00
Author
Owner
Copy Link
Copy Source

@SenorSmartyPants commented on GitHub (Mar 19, 2023):

Unfortunately not. The chapters won't get rebuilt unless an audio track changes. You could press Manage Tracks and change the order of a track, press save, then change the order back.

I can confirm this works. You don't even need to alter the track order. Just Manage Tracks -> Save. And chapter titles will update.

@SenorSmartyPants commented on GitHub (Mar 19, 2023): > Unfortunately not. The chapters won't get rebuilt unless an audio track changes. You could press Manage Tracks and change the order of a track, press save, then change the order back. I can confirm this works. You don't even need to alter the track order. Just Manage Tracks -> Save. And chapter titles will update.
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 enhancement
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#424
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?