[Enhancement] Podcasts support for nested seasons folder structure #991

New issue

Open

opened 2026-02-20 10:05:31 -05:00 by deekerman · 2 comments

deekerman commented

2026-02-20 10:05:31 -05:00

Owner

Originally created by @JAKAMI99 on GitHub (Feb 28, 2023).

Describe the issue

Sadly, audiobookshelf is not detecting the episode correctly.
It didn't work as intended from the beginning, starting with not detecting seasons, solved this trough adding one season per folder which ends up displaying every season as a single podcast, but that's okay.
Source files are from Audible.
I tried to append a hashtag (for example "#1 – Episode name") to the files as stated in the Documentation but this sadly didn't help.
(Tried rescanning and reading the library a few times)

Maybe add audible as a source for podcasts, or detect "audible original podcasts" in the book section.
Also possible to just set the season to the according number if a filename starts with a hashtag and a number (#1 - Episode XY)

Steps to reproduce the issue

As Explained: Just add some podcast episode to the library, where every season has its own folder.

Audiobookshelf version

2.2.15

How are you running audiobookshelf?

Docker

Originally created by @JAKAMI99 on GitHub (Feb 28, 2023). ### Describe the issue Sadly, audiobookshelf is not detecting the episode correctly. It didn't work as intended from the beginning, starting with not detecting seasons, solved this trough adding one season per folder which ends up displaying every season as a single podcast, but that's okay. Source files are from Audible. I tried to append a hashtag (for example "#1 – Episode name") to the files as stated in the [Documentation ](https://www.audiobookshelf.org/docs#podcast-directory-structure) but this sadly didn't help. (Tried rescanning and reading the library a few times) Maybe add audible as a source for podcasts, or detect "audible original podcasts" in the book section. Also possible to just set the season to the according number if a filename starts with a hashtag and a number (#1 - Episode XY) ### Steps to reproduce the issue 1. As Explained: Just add some podcast episode to the library, where every season has its own folder. ### Audiobookshelf version 2.2.15 ### How are you running audiobookshelf? Docker

deekerman added the

enhancement

label

2026-02-20 10:05:31 -05:00

deekerman commented

2026-02-20 10:05:32 -05:00

Author

Owner

@JAKAMI99 commented on GitHub (Feb 28, 2023):

Excuse the mentioning from issue #!1. Not intended.

@JAKAMI99 commented on GitHub (Feb 28, 2023): Excuse the mentioning from issue #!1. Not intended.

deekerman commented

2026-02-20 10:05:32 -05:00

Author

Owner

@Linden-Ryuujin commented on GitHub (Mar 20, 2023):

I've also just started playing with radio series and am running into this issue. Generally I order with season folders e.g:
The Hitchhikers Guide to the Galaxy/Series 1 - The Primary Phase/Episode 1 - Fit the First

I'd like to be able to use local file names, or metadata to tag a series (I guess metadata would be off topic for this request, but I just mention it in case that is a preferable alternative). The TV style S01E01 type naming convention might be worth considering if we're just looking at path.

@Linden-Ryuujin commented on GitHub (Mar 20, 2023): I've also just started playing with radio series and am running into this issue. Generally I order with season folders e.g: `The Hitchhikers Guide to the Galaxy/Series 1 - The Primary Phase/Episode 1 - Fit the First` I'd like to be able to use local file names, or metadata to tag a series (I guess metadata would be off topic for this request, but I just mention it in case that is a preferable alternative). The TV style S01E01 type naming convention might be worth considering if we're just looking at path.