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

[Enhancement]: Directory structure - extra layer option #952

New Issue
Closed
opened 2026-04-24 23:27:32 +02:00 by adam · 5 comments
adam commented 2026-04-24 23:27:32 +02:00
Owner
Copy Link
Copy Source

Originally created by @KaiStarkk on GitHub (Feb 12, 2023).

Describe the feature/enhancement

An optional additional layer(/s) in the directory structure would be a huge help.

There aren't many genres of fiction that aren't touched by this. For example here's the most famous fantasy author of the day:

Brandon Sanderson
├───Alcatraz
│   ├───Book 1 - Alcatraz Versus The Evil Librarians
│   ├───Book 2 - The Scrivener’s Bones
│   ├───Book 3 - The Knights of Crystallia
│   ├───Book 4 - Alcatraz Versus The Shattered Lens
│   └───Book 5 - Alcatraz Versus The Dark Talent
├───Cosmere
│   ├───1 - Elantris Saga
│   │   ├───1 - Elantris
│   │   ├───2 - The Hope of Elantris
│   │   └───3 - The Emperor's Soul
│   ├───2 - Mistborn Saga
│   │   ├───1 - The Original Trilogy
│   │   │   ├───Book 1 - The Final Empire
│   │   │   ├───Book 2 - The Well of Ascension
│   │   │   └───Book 3 - The Hero of Ages
│   │   ├───2 - Wax and Wayne series
│   │   │   ├───Book 4 - The Alloy Of Law
│   │   │   └───Book 5 - Shadows Of Self
│   │   └───3 - Mistborn [Collected Tales]
│   ├───3 - The Stormlight Archive
│   │   ├───Book 0.5 - Edgedancer
│   │   ├───Book 1 - The Way of Kings
│   │   ├───Book 2 - Words of Radiance
│   │   ├───Book 3 - Oathbringer
│   │   └───Book 4 - Rhythm of War
│   ├───Arcanum Unbounded The Cosmere Collection
│   └───Warbreaker
├───Infinity Blade
│   ├───Book 1 - Infinity Blade Awakening
│   └───Book 2 - Infinity Blade Redemption
├───Legion
│   └───Books 1-3 - Legion The Many Lives of Stephen Leeds
├───Perfect State
├───Rithmatist
├───Skyward
│   ├───Book 1 - Skyward
│   └───Book 2 - Starsight
├───The Reckoners
│   └───Book 1 - Steelheart
└───White Sand
    ├───Volume 1
    ├───Volume 2
    └───Volume 3
Originally created by @KaiStarkk on GitHub (Feb 12, 2023). ### Describe the feature/enhancement An optional additional layer(/s) in the directory structure would be a huge help. There aren't many genres of fiction that aren't touched by this. For example here's the most famous fantasy author of the day: ``` Brandon Sanderson ├───Alcatraz │ ├───Book 1 - Alcatraz Versus The Evil Librarians │ ├───Book 2 - The Scrivener’s Bones │ ├───Book 3 - The Knights of Crystallia │ ├───Book 4 - Alcatraz Versus The Shattered Lens │ └───Book 5 - Alcatraz Versus The Dark Talent ├───Cosmere │ ├───1 - Elantris Saga │ │ ├───1 - Elantris │ │ ├───2 - The Hope of Elantris │ │ └───3 - The Emperor's Soul │ ├───2 - Mistborn Saga │ │ ├───1 - The Original Trilogy │ │ │ ├───Book 1 - The Final Empire │ │ │ ├───Book 2 - The Well of Ascension │ │ │ └───Book 3 - The Hero of Ages │ │ ├───2 - Wax and Wayne series │ │ │ ├───Book 4 - The Alloy Of Law │ │ │ └───Book 5 - Shadows Of Self │ │ └───3 - Mistborn [Collected Tales] │ ├───3 - The Stormlight Archive │ │ ├───Book 0.5 - Edgedancer │ │ ├───Book 1 - The Way of Kings │ │ ├───Book 2 - Words of Radiance │ │ ├───Book 3 - Oathbringer │ │ └───Book 4 - Rhythm of War │ ├───Arcanum Unbounded The Cosmere Collection │ └───Warbreaker ├───Infinity Blade │ ├───Book 1 - Infinity Blade Awakening │ └───Book 2 - Infinity Blade Redemption ├───Legion │ └───Books 1-3 - Legion The Many Lives of Stephen Leeds ├───Perfect State ├───Rithmatist ├───Skyward │ ├───Book 1 - Skyward │ └───Book 2 - Starsight ├───The Reckoners │ └───Book 1 - Steelheart └───White Sand ├───Volume 1 ├───Volume 2 └───Volume 3 ```
adam added the enhancement label 2026-04-24 23:27:32 +02:00
adam closed this issue 2026-04-24 23:27:33 +02:00
adam commented 2026-04-24 23:27:35 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Feb 12, 2023):

Can you explain some more what I'm looking at? Are these series with sub-series? How could the scanner know if it is a sub-series?

@advplyr commented on GitHub (Feb 12, 2023): Can you explain some more what I'm looking at? Are these series with sub-series? How could the scanner know if it is a sub-series?
adam commented 2026-04-24 23:27:36 +02:00
Author
Owner
Copy Link
Copy Source

@hobesman commented on GitHub (Feb 12, 2023):

It's a universe (Cosmere) with series (Mistborn) and sub series (Mistborn Original Trilogy, Wax and Wayne).

@hobesman commented on GitHub (Feb 12, 2023): It's a universe (Cosmere) with series (Mistborn) and sub series (Mistborn Original Trilogy, Wax and Wayne).
adam commented 2026-04-24 23:27:37 +02:00
Author
Owner
Copy Link
Copy Source

@KaiStarkk commented on GitHub (Feb 13, 2023):

Correct - and as for how the scanner could do this, the way that makes most sense to me would be to allow collections to hold series, then have the following:

Four level structure;
Author > Collection > Series > Book

Fifth level structure:
Author > Collection > Series > Sub-series > Book

Sixth level structure and higher:
Author > Collection > … > Collection > Series > Sub-series > Book

This would cover any author I’ve seen so far including the big series writers like King, Feist, Sanderson etc. who divide their works into universes, cycles, sagas etc. could also separate their fiction from their non-fiction in this way.

Also allows nicely for non-fiction writers and classics - e.g. separating Blake’s essays, letters, poetry, short stories, etc.

But I might not be using collection correctly there?
Will admit I’m not fully clear on what collection is for. It seems it can only hold books so might be intended for standards like “DNF”, “Currently reading”, “Up next”? If so maybe they could be made built in like “Finished” currently is - (and sync to Goodreads / TheStoryGraph shelves)

@KaiStarkk commented on GitHub (Feb 13, 2023): Correct - and as for how the scanner could do this, the way that makes most sense to me would be to allow collections to hold series, then have the following: Four level structure; Author > Collection > Series > Book Fifth level structure: Author > Collection > Series > Sub-series > Book Sixth level structure and higher: Author > Collection > … > Collection > Series > Sub-series > Book This would cover any author I’ve seen so far including the big series writers like King, Feist, Sanderson etc. who divide their works into universes, cycles, sagas etc. could also separate their fiction from their non-fiction in this way. Also allows nicely for non-fiction writers and classics - e.g. separating Blake’s essays, letters, poetry, short stories, etc. But I might not be using collection correctly there? Will admit I’m not fully clear on what collection is for. It seems it can only hold books so might be intended for standards like “DNF”, “Currently reading”, “Up next”? If so maybe they could be made built in like “Finished” currently is - (and sync to Goodreads / TheStoryGraph shelves)
adam commented 2026-04-24 23:27:37 +02:00
Author
Owner
Copy Link
Copy Source

@KaiStarkk commented on GitHub (Feb 27, 2023):

I've realised this can be merged with #870

@KaiStarkk commented on GitHub (Feb 27, 2023): I've realised this can be merged with #870
adam commented 2026-04-24 23:27:37 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Feb 27, 2023):

Duplicate of #870

thanks

@advplyr commented on GitHub (Feb 27, 2023): Duplicate of #870 thanks
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 enhancement
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#952
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?