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]: Allow creation of collections without requiring books (UI + API) #2803

New Issue
Open
opened 2026-04-25 00:10:47 +02:00 by adam · 0 comments
adam commented 2026-04-25 00:10:47 +02:00
Owner
Copy Link
Copy Source

Originally created by @khalina on GitHub (May 26, 2025).

Type of Enhancement

Server Backend

Describe the Feature/Enhancement

Summary:
Currently, both the Audiobookshelf UI and API require that a collection be created with at least one book. This limits organizational and automation use cases.

Use Case

Many users would probably want to:

  • Pre-build empty collections (e.g., reading orders, series folders, author collections)
  • Import curated reading lists via scripts
  • Organize their libraries before content is fully available
  • Be able to restore prebuilt collections after having to rebuild an Audiobookshelf server from scratch

My Current Workaround

To create a collection to allow me to import it from a text file, I have to:

  1. Add an existing unrelated book when creating the collection from Library
  2. Manually remove that book afterward in the Collections tab
  3. Then use the API call to populate the Collection with my text file

This works, but it's inelegant and adds unnecessary steps for both UI users and API clients.

Suggested Solution

Allow the /api/collections POST endpoint to accept a minimal payload like:

{
  "libraryId": "abc123",
  "name": "Temporary Books Reading Order"
}



### Why would this be helpful?

Many users would probably want to:

- Pre-build empty collections (e.g., reading orders, series folders, author collections)
- Import curated reading lists via scripts
- Organize their libraries before content is fully available
- Be able to restore prebuilt collections after having to rebuild an Audiobookshelf server from scratch

### Future Implementation (Screenshot)

![Image](https://github.com/user-attachments/assets/878b1d4a-e180-4219-9e5c-2b9168f2ac04)
Apologies for the bad picture.  I think a button or a selection on the side would work.

### Audiobookshelf Server Version

v2.23.0

### Current Implementation (Screenshot)

I was trying to optimise my reading order creation in Collections by using API calls.  I can't  create an empty collection in Collections on the UI or via the API.
Originally created by @khalina on GitHub (May 26, 2025). ### Type of Enhancement Server Backend ### Describe the Feature/Enhancement **Summary:** Currently, both the **Audiobookshelf UI** and **API** require that a collection be created with at least one book. This limits organizational and automation use cases. --- ### Use Case Many users would probably want to: - Pre-build empty collections (e.g., reading orders, series folders, author collections) - Import curated reading lists via scripts - Organize their libraries before content is fully available - Be able to restore prebuilt collections after having to rebuild an Audiobookshelf server from scratch --- ### My Current Workaround To create a collection to allow me to import it from a text file, I have to: 1. Add an existing unrelated book when creating the collection from Library 2. Manually remove that book afterward in the Collections tab 3. Then use the API call to populate the Collection with my text file This works, but it's inelegant and adds unnecessary steps for both UI users and API clients. --- ### Suggested Solution Allow the `/api/collections` POST endpoint to accept a minimal payload like: ```json { "libraryId": "abc123", "name": "Temporary Books Reading Order" } ### Why would this be helpful? Many users would probably want to: - Pre-build empty collections (e.g., reading orders, series folders, author collections) - Import curated reading lists via scripts - Organize their libraries before content is fully available - Be able to restore prebuilt collections after having to rebuild an Audiobookshelf server from scratch ### Future Implementation (Screenshot) ![Image](https://github.com/user-attachments/assets/878b1d4a-e180-4219-9e5c-2b9168f2ac04) Apologies for the bad picture. I think a button or a selection on the side would work. ### Audiobookshelf Server Version v2.23.0 ### Current Implementation (Screenshot) I was trying to optimise my reading order creation in Collections by using API calls. I can't create an empty collection in Collections on the UI or via the API.
adam added the enhancement label 2026-04-25 00:10:47 +02:00
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#2803
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?