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

[PR #4681] Add Support for reading in "tags" metadata from audiofiles #4314

New Issue
Open
opened 2026-04-25 00:19:15 +02:00 by adam · 0 comments
adam commented 2026-04-25 00:19:15 +02:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/advplyr/audiobookshelf/pull/4681
Author: @srobe92
Created: 9/16/2025
Status: 🔄 Open

Base: master ← Head: master

📝 Commits (3)

  • da8b481 Add support for tags in AudioFileScanner
  • 37ca648 Add tagGenre1 property to AudioMetaTags
  • a9e55ab Add additional parameters to tryGrabTags for genre1

📊 Changes

3 files changed (+11 additions, -1 deletions)

View changed files

📝 server/objects/metadata/AudioMetaTags.js (+4 -0)
📝 server/scanner/AudioFileScanner.js (+6 -0)
📝 server/utils/prober.js (+1 -1)

📄 Description

Brief summary

Added support for reading in "tags" metadata information from audio files.

Which issue is fixed?

N/A

In-depth Description

Currently, ABS does not support reading tag metadata from audio files. This makes it difficult to maintain consistent tags when moving books between ABS libraries or when pre-processing files with embedded tag information.

This update adds support for mapping extended tags (genre1) from an audio file into the tags category within ABS. I chose genre1 because it was already present in the prober file. Updates in metadata/AudioMetaTags.js and scanner/AudioFileScanner.js handle genre1 the same way as genre, with the exception that it maps to tags instead of genres.

With this change, if an audio file has embedded extended tags, ABS will successfully parse and display them in the tags category.

Note: This change only extracts existing tags from audio files. It does not write tag metadata back into audio files if using “quick embed” or the manager tools to re-encode.

How have you tested this?

Updated 3 files in my Docker container.

  • Restarted the container.
  • Added new audiobooks to the library.
  • Verified that the tags field was successfully read and mapped.

Notes:
I am a novice developer. These exact changes may not be production-ready, but I wanted to highlight the issue and provide a working example of a solution. The logic is straightforward, and I don’t expect breaking changes, but I have only tested this inside my own container.

Screenshots

Current ABS Upload:
current_abs_upload

Updated ABS Upload:
pullreq_abs_upload

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/advplyr/audiobookshelf/pull/4681 **Author:** [@srobe92](https://github.com/srobe92) **Created:** 9/16/2025 **Status:** 🔄 Open **Base:** `master` ← **Head:** `master` --- ### 📝 Commits (3) - [`da8b481`](https://github.com/advplyr/audiobookshelf/commit/da8b4811683c3aedfbacba696be2b7bd37ac4bd0) Add support for tags in AudioFileScanner - [`37ca648`](https://github.com/advplyr/audiobookshelf/commit/37ca6483544b49f6220efa5b2becd548b16d967d) Add tagGenre1 property to AudioMetaTags - [`a9e55ab`](https://github.com/advplyr/audiobookshelf/commit/a9e55ab6e81abac7ced53910534a55a8ada8c05f) Add additional parameters to tryGrabTags for genre1 ### 📊 Changes **3 files changed** (+11 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `server/objects/metadata/AudioMetaTags.js` (+4 -0) 📝 `server/scanner/AudioFileScanner.js` (+6 -0) 📝 `server/utils/prober.js` (+1 -1) </details> ### 📄 Description ## Brief summary Added support for reading in "tags" metadata information from audio files. ## Which issue is fixed? N/A ## In-depth Description Currently, ABS does not support reading tag metadata from audio files. This makes it difficult to maintain consistent tags when moving books between ABS libraries or when pre-processing files with embedded tag information. This update adds support for mapping extended tags (genre1) from an audio file into the tags category within ABS. I chose genre1 because it was already present in the prober file. Updates in metadata/AudioMetaTags.js and scanner/AudioFileScanner.js handle genre1 the same way as genre, with the exception that it maps to tags instead of genres. With this change, if an audio file has embedded extended tags, ABS will successfully parse and display them in the tags category. Note: This change only extracts existing tags from audio files. It does not write tag metadata back into audio files if using “quick embed” or the manager tools to re-encode. ## How have you tested this? Updated 3 files in my Docker container. * Restarted the container. * Added new audiobooks to the library. * Verified that the tags field was successfully read and mapped. Notes: I am a novice developer. These exact changes may not be production-ready, but I wanted to highlight the issue and provide a working example of a solution. The logic is straightforward, and I don’t expect breaking changes, but I have only tested this inside my own container. ## Screenshots Current ABS Upload: <img width="631" height="548" alt="current_abs_upload" src="https://github.com/user-attachments/assets/6fed5eb4-a7d0-4ebf-bd8a-33f30fc4c11a" /> Updated ABS Upload: <img width="528" height="459" alt="pullreq_abs_upload" src="https://github.com/user-attachments/assets/2e9c943b-cc4a-4055-bd5d-1fb738e21287" /> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2026-04-25 00:19:15 +02:00
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 pull-request
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#4314
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?