[Bug]: Podcast Metadata Not Written to Disk #3247

Open
opened 2026-04-25 00:14:30 +02:00 by adam · 0 comments
Owner

Originally created by @btxshark1 on GitHub (Feb 28, 2026).

What happened?

Global toggle for writing metadata next to the library item is not applied to podcast libraries.
There is no metadata.json written alongside files for 'podcast' type libraries so any changes are lost when moving the library around.

What did you expect to happen?

A metadata.json file to be written next to the podcast episode so metadata is persistent.

Steps to reproduce the issue

  1. Settings -> Store metadata with item is toggled ON
  2. Add a podcast library and some podcasts
  3. Create/update episode/title/description/etc
  4. no metadata.json is written

Audiobookshelf version

2.32.1

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?

None

Logs

audiobookshelf  | [2026-02-28 10:02:50.269] INFO: [PodcastController] Updated episode "Death in the Stars" keys [ 'description' ]

Additional Notes

#1488 #4959 #4594 and #4304 are centered around embedding this in the mp3 tags directly, and so don't really address this inconsistency.
Having the data stored next to the library files helps with portability since restoring backups also overwrites system settings that may not be applicable.

Since podcast libraries are structured differently (flat, compared to books) it might work best to write it as {{episodeFile}}.json but I can also see a benefit to writing a single metadata.json for the whole podcast and just appending episodes to that as they're added.

Originally created by @btxshark1 on GitHub (Feb 28, 2026). ### What happened? Global toggle for writing metadata next to the library item is not applied to podcast libraries. There is no metadata.json written alongside files for 'podcast' type libraries so any changes are lost when moving the library around. ### What did you expect to happen? A metadata.json file to be written next to the podcast episode so metadata is persistent. ### Steps to reproduce the issue 1. Settings -> Store metadata with item is toggled ON 2. Add a podcast library and some podcasts 3. Create/update episode/title/description/etc 4. no metadata.json is written ### Audiobookshelf version 2.32.1 ### 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? None ### Logs ```shell audiobookshelf | [2026-02-28 10:02:50.269] INFO: [PodcastController] Updated episode "Death in the Stars" keys [ 'description' ] ``` ### Additional Notes #1488 #4959 #4594 and #4304 are centered around embedding this in the mp3 tags directly, and so don't really address this inconsistency. Having the data stored next to the library files helps with portability since restoring backups also overwrites system settings that may not be applicable. Since podcast libraries are structured differently (flat, compared to books) it might work best to write it as {{episodeFile}}.json but I can also see a benefit to writing a single metadata.json for the whole podcast and just appending episodes to that as they're added.
adam added the bug label 2026-04-25 00:14:30 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3247