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]: custom metadata provider for podcasts #2917

New Issue
Open
opened 2026-04-25 00:11:50 +02:00 by adam · 5 comments
adam commented 2026-04-25 00:11:50 +02:00
Owner
Copy Link
Copy Source

Originally created by @LaserKaspar on GitHub (Jul 26, 2025).

Type of Enhancement

None

Describe the Feature/Enhancement

Hello, is it possible to provide custom metadata to podcasts?
Something like a .plexmatch file (if something similar already exists this would solve my issue as well) or a Custom Metadata Provider Media Type for Podcasts. Currently Custom Metadata Providers only seem to support libraries of type Book.

Why would this be helpful?

I would like to provide custom metadata to some of my files using either a http service or a file in the same folder. Currently everything is extracted from the mp3 files but the metadata on these is not consistent and therefore useless and due to some other limitations it is not possible to change the metadata of the files directly.

Due to that the sorting of episodes is broken:

Image

And I would like to be able to provide the published data, episode number, season number, title & description of an Episode myself.

Linking an episode automatically (based on filename) to an rss feed would also be an option.

EDIT:

  • Seems like quick matching uses the title of mp3 tag? If that would use a file name all my issues would probably be solved.
Image

Thanks (:

Future Implementation (Screenshot)

Image

Audiobookshelf Server Version

v2.26.3

Current Implementation (Screenshot)

Settings -> Item Metadata Utils -> Custom Metadata Providers -> Add

Image
Originally created by @LaserKaspar on GitHub (Jul 26, 2025). ### Type of Enhancement None ### Describe the Feature/Enhancement Hello, is it possible to provide custom metadata to podcasts? Something like a .plexmatch file (if something similar already exists this would solve my issue as well) or a Custom Metadata Provider Media Type for Podcasts. Currently Custom Metadata Providers only seem to support libraries of type Book. ### Why would this be helpful? I would like to provide custom metadata to some of my files using either a http service or a file in the same folder. Currently everything is extracted from the mp3 files but the metadata on these is not consistent and therefore useless and due to some other limitations it is not possible to change the metadata of the files directly. Due to that the sorting of episodes is broken: <img width="211" height="65" alt="Image" src="https://github.com/user-attachments/assets/c2a8913f-0f6a-4310-b90c-b52ac276faa0" /> And I would like to be able to provide the published data, episode number, season number, title & description of an Episode myself. Linking an episode automatically (based on filename) to an rss feed would also be an option. EDIT: - Seems like quick matching uses the title of mp3 tag? If that would use a file name all my issues would probably be solved. <img width="788" height="203" alt="Image" src="https://github.com/user-attachments/assets/9fc7d09a-2ead-4147-a0f2-a5147c6abc40" /> Thanks (: ### Future Implementation (Screenshot) <img width="170" height="164" alt="Image" src="https://github.com/user-attachments/assets/f573fb9b-7d48-4cfa-814a-41e253ec7397" /> ### Audiobookshelf Server Version v2.26.3 ### Current Implementation (Screenshot) Settings -> Item Metadata Utils -> Custom Metadata Providers -> Add <img width="136" height="88" alt="Image" src="https://github.com/user-attachments/assets/97ee14c0-3f0c-4d5e-9bbb-cbd653726bde" />
adam added the enhancement label 2026-04-25 00:11:50 +02:00
adam commented 2026-04-25 00:11:51 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (Jul 26, 2025):

Podcast metadata is obtained directly from the RSS feed. If you are hosting the RSS feed locally, you just need to set the RSS feed for the podcast within Audiobookshelf.

@nichwall commented on GitHub (Jul 26, 2025): Podcast metadata is obtained directly from the RSS feed. If you are hosting the RSS feed locally, you just need to set the RSS feed for the podcast within Audiobookshelf.
adam commented 2026-04-25 00:11:51 +02:00
Author
Owner
Copy Link
Copy Source

@LaserKaspar commented on GitHub (Jul 26, 2025):

Podcast metadata is obtained directly from the RSS feed. If you are hosting the RSS feed locally, you just need to set the RSS feed for the podcast within Audiobookshelf.

The podcast url is set it also finds a match if I put it the filename as a search parameter. But ABS defaults search term to the mp3 tag title field and some of these are not set correctly by the published provider.
I have already downloaded everything and I don't want ABS to handle the downloading for me.

https://github.com/advplyr/audiobookshelf/blob/0107cb4782536ea159c4f65960eb4ff89c5f9366/server/utils/podcastUtils.js#L423-L452

Might look into changing the searchTitle for the Scanner to episode.audioFile.metadata.filename

https://github.com/advplyr/audiobookshelf/blob/0107cb4782536ea159c4f65960eb4ff89c5f9366/server/scanner/Scanner.js#L372-L378

The Scanner is most useful when there is no metadata in the file (e.g. no correct episode.title) so I think this would be a sensible change.

EDIT: See the image I now added to the original post.

@LaserKaspar commented on GitHub (Jul 26, 2025): > Podcast metadata is obtained directly from the RSS feed. If you are hosting the RSS feed locally, you just need to set the RSS feed for the podcast within Audiobookshelf. The podcast url is set it also finds a match if I put it the filename as a search parameter. But ABS defaults search term to the mp3 tag title field and some of these are not set correctly by the published provider. I have already downloaded everything and I don't want ABS to handle the downloading for me. https://github.com/advplyr/audiobookshelf/blob/0107cb4782536ea159c4f65960eb4ff89c5f9366/server/utils/podcastUtils.js#L423-L452 Might look into changing the searchTitle for the Scanner to episode.audioFile.metadata.filename https://github.com/advplyr/audiobookshelf/blob/0107cb4782536ea159c4f65960eb4ff89c5f9366/server/scanner/Scanner.js#L372-L378 The Scanner is most useful when there is no metadata in the file (e.g. no correct episode.title) so I think this would be a sensible change. EDIT: See the image I now added to the original post.
adam commented 2026-04-25 00:11:51 +02:00
Author
Owner
Copy Link
Copy Source

@LaserKaspar commented on GitHub (Aug 7, 2025):

So I decided to do the work and retag all my files. Fixing this behavior would still be a welcome addition in my opinion. Matching works now.
But I have another issue:
Quick Match is not automatically done for newly added episodes that are found when doing a (scheduled) re-scan of the podcast/library. Is this by design?

@LaserKaspar commented on GitHub (Aug 7, 2025): So I decided to do the work and retag all my files. Fixing this behavior would still be a welcome addition in my opinion. Matching works now. But I have another issue: Quick Match is not automatically done for newly added episodes that are found when doing a (scheduled) re-scan of the podcast/library. Is this by design?
adam commented 2026-04-25 00:11:51 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (Aug 8, 2025):

But I have another issue: Quick Match is not automatically done for newly added episodes that are found when doing a (scheduled) re-scan of the podcast/library. Is this by design?

All matching against online providers (i.e. outside sources) is intentionally a manual action initiated by the user. Matching against online providers is separate and distinct from scanning the local file system.

@nichwall commented on GitHub (Aug 8, 2025): > But I have another issue: Quick Match is not automatically done for newly added episodes that are found when doing a (scheduled) re-scan of the podcast/library. Is this by design? All matching against online providers (i.e. outside sources) is intentionally a manual action initiated by the user. Matching against online providers is separate and distinct from scanning the local file system.
adam commented 2026-04-25 00:11:51 +02:00
Author
Owner
Copy Link
Copy Source

@LaserKaspar commented on GitHub (Sep 4, 2025):

Thanks for the answer. I have now tagged my files with additional info so the metadata is complete in ABS and I don't need to rely on external metadata.

I still have a Question about the metadata extraction from the mp3 files, specifically this:
https://github.com/advplyr/audiobookshelf/blob/e510174f12c1b0216fd41e682383253106293a89/server/utils/prober.js#L185-L185

Which should be used by a podcast episode:
https://github.com/advplyr/audiobookshelf/blob/85d5531bc162eaa1a5a24fddb27b460cf320f5db/server/scanner/AudioFileScanner.js#L431-L431

When scanning it seems like it always prefers the TYER tag even though I provided a custom DATE tag with full date info not only the year. And it only uses it if TYER is not present. TryGrabTags seems to do them in order so I don't really know what to do to make it use DATE instead of TYER without deleting TYER.

My ID3 looks like this:

:00:00.TYER.....
..2025.XDOR.....
..2025-08-05T07:
00:00.DATE......
.2025-08-05T07:0
0:00.000Z.......

But it maps to:
Mapping metadata to key tagDate => pubDate: 2025

Also for some reason it won't read the description. I tried tags "DESC" and "COMM" both are not imported in ABS for some reason...

@LaserKaspar commented on GitHub (Sep 4, 2025): Thanks for the answer. I have now tagged my files with additional info so the metadata is complete in ABS and I don't need to rely on external metadata. I still have a Question about the metadata extraction from the mp3 files, specifically this: https://github.com/advplyr/audiobookshelf/blob/e510174f12c1b0216fd41e682383253106293a89/server/utils/prober.js#L185-L185 Which should be used by a podcast episode: https://github.com/advplyr/audiobookshelf/blob/85d5531bc162eaa1a5a24fddb27b460cf320f5db/server/scanner/AudioFileScanner.js#L431-L431 When scanning it seems like it always prefers the TYER tag even though I provided a custom DATE tag with full date info not only the year. And it only uses it if TYER is not present. TryGrabTags seems to do them in order so I don't really know what to do to make it use DATE instead of TYER without deleting TYER. My ID3 looks like this: ``` :00:00.TYER..... ..2025.XDOR..... ..2025-08-05T07: 00:00.DATE...... .2025-08-05T07:0 0:00.000Z....... ``` But it maps to: ```Mapping metadata to key tagDate => pubDate: 2025``` Also for some reason it won't read the description. I tried tags "DESC" and "COMM" both are not imported in ABS for some reason...
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#2917
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?