[Enhancement]: Custom user agent fallback field. #3308

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

Originally created by @Truth-And-Reason on GitHub (Apr 19, 2026).

Type of Enhancement

None

Describe the Feature/Enhancement

Could we please get a custom user agent fallback field added to the podcast details page between the "RSS Feed URL" and the "Description" field. The field would only be used on a per podcast basis if the ABS defaults fail.

Why would this be helpful?

I know there have been issues with the user agents previously , and this has been modified over the last 12 months.
An issue still persists if you live outside the US and host your own ABS instance with a registered domain name pointing to your home server. The advertising and marketing software used by certain podcasts often blocks downloads from ABS based on the user agent combined with the location. It probably has something to do with redirecting users to streams with regional advertising. This redirection still works but certain platforms still block the download.

This regional difference is also why the devs can't always reproduce the problems with certain downloads.

I think adding this would be helpful to users trouble shooting their server.
It will allow a work around users can apply on an "only as needed" basis.
It will also reduce the number of bug reports submitted that stem from issues created by podcast platforms, not ABS.

Future Implementation (Screenshot)

A custom user agent fallback field added to the podcast details page between the "RSS Feed URL" and the "Description" field.

Audiobookshelf Server Version

v2.33.1

Current Implementation (Screenshot)

Researching my own issue and found many others that match.

Originally created by @Truth-And-Reason on GitHub (Apr 19, 2026). ### Type of Enhancement None ### Describe the Feature/Enhancement Could we please get a custom user agent fallback field added to the podcast details page between the "RSS Feed URL" and the "Description" field. The field would only be used on a per podcast basis if the ABS defaults fail. ### Why would this be helpful? I know there have been issues with the user agents previously , and this has been modified over the last 12 months. An issue still persists if you live outside the US and host your own ABS instance with a registered domain name pointing to your home server. The advertising and marketing software used by certain podcasts often blocks downloads from ABS based on the user agent combined with the location. It probably has something to do with redirecting users to streams with regional advertising. This redirection still works but certain platforms still block the download. This regional difference is also why the devs can't always reproduce the problems with certain downloads. I think adding this would be helpful to users trouble shooting their server. It will allow a work around users can apply on an "only as needed" basis. It will also reduce the number of bug reports submitted that stem from issues created by podcast platforms, not ABS. ### Future Implementation (Screenshot) A custom user agent fallback field added to the podcast details page between the "RSS Feed URL" and the "Description" field. ### Audiobookshelf Server Version v2.33.1 ### Current Implementation (Screenshot) Researching my own issue and found many others that match.
adam added the enhancement label 2026-04-25 00:14:51 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3308