audiobookshelf/artifacts/2026-02-15/consolidation_badge.md

Not Consolidated Badge Specification

Overview

Add a visual indicator (badge) to the book thumbnail card in listings to identify books that are not "consolidated". Consolidation means the book's folder name matches the standard Author - Title format.

Requirements

• The badge should only appear if the folder name does not match the sanitized Author - Title format.
• Only applicable to Books (not Podcasts).
• Only applicable to library items in folders (not single files).
• The badge should have a descriptive tooltip ("Not Consolidated").
• The badge should be clearly visible but not obstructive.
• The badge position should account for other status indicators (RSS, shared icon) to avoid overlap.

Implementation Details

Backend (Server)

• Model: LibraryItem (server/models/LibraryItem.js)
• Logic: Enhanced checkIsNotConsolidated() which:
  1. Checks if the item is a book folder (not a single file).
  2. Sanitizes the Author - Title name using LibraryItem.getConsolidatedFolderName(author, title).
  3. Compares the sanitized name with the folder's name (Path.basename(this.path)).
  4. Subfolder Check: Verifies the item is located at the root of the library folder. If it's in a subfolder (e.g., Author/Title), it's considered "Not Consolidated" even if the folder name is correct.

Library-wide Status Update Tool

A tool was added to the Library Settings to allow manual re-evaluation of the consolidation status for all items.

• Frontend: Added "Update Consolidation Status" button in Library Settings -> Tools tab.
• Backend Controller: LibraryController.updateConsolidationStatus
• API: POST /api/libraries/:id/update-consolidation
• Behavior: Iterates through all items in the library, runs checkIsNotConsolidated(), and updates the database flag if it has changed. This is useful if the folder structure was manually altered on disk outside of the application.

Frontend (Client)

• Component: LazyBookCard (client/components/cards/LazyBookCard.vue)
• UI: Added a folder icon badge with a yellow background (bg-warning).
• Logic: Toggles visibility based on the libraryItem.isNotConsolidated flag.
• Positioning: Absolute positioning on the bottom-left side (bottom: 0.375em, left: 0).

View Book Page

• Component: client/pages/item/_id/index.vue
• UI (Badge): Badge added next to the book title when isNotConsolidated is true.
• UI (Button): "Consolidate" button added to the primary action row (after Edit and Mark as Finished).
• Behavior: The "Consolidate" button is disabled if the book is already consolidated.
• Robustness: Modified handleMoveLibraryItem to correctly identify when a book is already at its target path, avoiding redundant file operations and preventing "destination already exists" errors.