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]: GUID unstable in RSS feeds since 2.17.6 #2445

New Issue
Closed
opened 2026-04-25 00:07:13 +02:00 by adam · 6 comments
adam commented 2026-04-25 00:07:13 +02:00
Owner
Copy Link
Copy Source

Originally created by @Drikanis on GitHub (Dec 30, 2024).

What happened?

The GUIDs for items in the RSS feeds don't appear to be stable, and occasionally every GUID on every item changes. When this happens, feedreaders (FreshRSS in my case) determine that every item with a new GUID is a new item that hasn't been viewed.

What did you expect to happen?

GUIDs for items should never change.

Steps to reproduce the issue

  1. Open an RSS feed
  2. Wait for the GUID to change (not sure what triggers it)

Audiobookshelf version

v2.17.6

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

[2024-12-30 12:20:04.989] INFO: [Server] Requesting rss feed cf1b8e4a-cd24-469c-a745-68585810984f
[2024-12-30 12:20:05.031] INFO: [RssFeedManager] Feed "It‘s Probably (not) Aliens!" requires update - updating feed
[2024-12-30 12:20:05.546] INFO: [FeedEpisode] Creating 132 episodes for feed a6c2c816-3a81-4dbd-93b6-f2da196fa623

Additional Notes

This also seems to affect download links. "Old" download URLs and embedded players in feed items are no longer valid after the GUIDs are regenerated.

Originally created by @Drikanis on GitHub (Dec 30, 2024). ### What happened? The GUIDs for items in the RSS feeds don't appear to be stable, and occasionally every GUID on every item changes. When this happens, feedreaders (FreshRSS in my case) determine that every item with a new GUID is a new item that hasn't been viewed. ### What did you expect to happen? GUIDs for items should never change. ### Steps to reproduce the issue 1. Open an RSS feed 2. Wait for the GUID to change (not sure what triggers it) ### Audiobookshelf version v2.17.6 ### 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 [2024-12-30 12:20:04.989] INFO: [Server] Requesting rss feed cf1b8e4a-cd24-469c-a745-68585810984f [2024-12-30 12:20:05.031] INFO: [RssFeedManager] Feed "It‘s Probably (not) Aliens!" requires update - updating feed [2024-12-30 12:20:05.546] INFO: [FeedEpisode] Creating 132 episodes for feed a6c2c816-3a81-4dbd-93b6-f2da196fa623 ``` ### Additional Notes This also seems to affect download links. "Old" download URLs and embedded players in feed items are no longer valid after the GUIDs are regenerated.
adam added the bug label 2026-04-25 00:07:13 +02:00
adam closed this issue 2026-04-25 00:07:13 +02:00
adam commented 2026-04-25 00:07:13 +02:00
Author
Owner
Copy Link
Copy Source

@nichwall commented on GitHub (Dec 31, 2024):

Do you have an example of part of an RSS feed where the GUID changes you can share?

Can you clarify "occasionally"? Like is it:

  • After a server update or restart
  • When you download a new podcast episode or add a new item to the RSS feed
  • At a regular cadence (like every 15, 30, 60 minutes)
  • Something else?

There was a migration for the Feeds table in 2.17.6, so this might be related to this migration but it sounds like this was already happening based on the "occasionally happens" because this issue was opened the same day as when 2.17.6 released.

(Edited for clarity)

@nichwall commented on GitHub (Dec 31, 2024): Do you have an example of part of an RSS feed where the GUID changes you can share? Can you clarify "occasionally"? Like is it: - After a server update or restart - When you download a new podcast episode or add a new item to the RSS feed - At a regular cadence (like every 15, 30, 60 minutes) - Something else? There was a migration for the Feeds table in 2.17.6, so this might be related to this migration but it sounds like this was already happening based on the "occasionally happens" because this issue was opened the same day as when 2.17.6 released. (Edited for clarity)
adam commented 2026-04-25 00:07:13 +02:00
Author
Owner
Copy Link
Copy Source

@Drikanis commented on GitHub (Dec 31, 2024):

It changes the episode id part of the "guid" field on the item:
image

I opened my feedreader the morning after updating to find every episode in the history of the podcast duplicated 6 times each in my feed reader. Based off that it would appear to be happening every hour, which is what the schedule is set to.
image

Waiting to the top of the hour and the same item screenshotted above now has a different episodeId/guid:
image

Glancing at the changes in the 2.17.6 code, it appears it is not persisting the episode id at all, and generates a new one every time the episodes are reloaded.

@Drikanis commented on GitHub (Dec 31, 2024): It changes the episode id part of the "guid" field on the item: ![image](https://github.com/user-attachments/assets/9dc1691b-65aa-4928-bb2d-dcd7027ab22d) I opened my feedreader the morning after updating to find every episode in the history of the podcast duplicated 6 times each in my feed reader. Based off that it would appear to be happening every hour, which is what the schedule is set to. ![image](https://github.com/user-attachments/assets/42857135-912a-4905-ac6e-cb5ea954f09a) Waiting to the top of the hour and the same item screenshotted above now has a different episodeId/guid: ![image](https://github.com/user-attachments/assets/92d3fb47-4002-449c-8032-47806dd5d7bd) Glancing at the changes in the 2.17.6 code, it appears it is not persisting the episode id at all, and generates a new one every time the episodes are reloaded.
adam commented 2026-04-25 00:07:14 +02:00
Author
Owner
Copy Link
Copy Source

@Drikanis commented on GitHub (Dec 31, 2024):

In FreshRSS I'm at least able to adjust the article unicity criteria from standard GUID to "Link + Date + Title" which appears to remain stable in the feeds produced by 2.17.6 of audiobookshelf, so there is at least a work around for that feed reader. I don't know how prolific such similar settings are in other feed readers, or how other readers behave when the guids for existing items change.

@Drikanis commented on GitHub (Dec 31, 2024): In FreshRSS I'm at least able to adjust the article unicity criteria from standard GUID to "Link + Date + Title" which appears to remain stable in the feeds produced by 2.17.6 of audiobookshelf, so there is at least a work around for that feed reader. I don't know how prolific such similar settings are in other feed readers, or how other readers behave when the guids for existing items change.
adam commented 2026-04-25 00:07:14 +02:00
Author
Owner
Copy Link
Copy Source

@duckmaster175 commented on GitHub (Dec 31, 2024):

I'm having the same issue. I use yt-dlp to download the audio from some streams, to listen to later in my podcast player on my phone. It seems like every time a new file is added or removed, or it rescans, it makes a new GUID for all the files. This causes my podcast player to redownload everything again as if it were new.

@duckmaster175 commented on GitHub (Dec 31, 2024): I'm having the same issue. I use yt-dlp to download the audio from some streams, to listen to later in my podcast player on my phone. It seems like every time a new file is added or removed, or it rescans, it makes a new GUID for all the files. This causes my podcast player to redownload everything again as if it were new.
adam commented 2026-04-25 00:07:14 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Jan 1, 2025):

I know why this is happening and am working on a fix now.

@advplyr commented on GitHub (Jan 1, 2025): I know why this is happening and am working on a fix now.
adam commented 2026-04-25 00:07:14 +02:00
Author
Owner
Copy Link
Copy Source

@github-actions[bot] commented on GitHub (Jan 1, 2025):

Fixed in v2.17.7.

@github-actions[bot] commented on GitHub (Jan 1, 2025): Fixed in [v2.17.7](https://github.com/advplyr/audiobookshelf/releases/tag/v2.17.7).
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#2445
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?