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

Select All Keyboard Shortcut Specification

Overview

Enable Ctrl+A (or Cmd+A on macOS) to select all items in the library listing screen.

Date

2026-02-15

User Interface

• Component: client/components/app/LazyBookshelf.vue
• Trigger: Global keydown event listener active when the bookshelf is mounted.
• Shortcut: Ctrl+A / Cmd+A.
• Behavior:
  • Selects all currently loaded items in the bookshelf.
  • Sets a isSelectAll flag that automatically selects newly loaded items as the user scrolls.
  • Updates the "Selection Mode" UI with the total count of selected items.
  • Clicking/Deselecting an individual item while isSelectAll is active will toggle off the isSelectAll persistent state (but keep existing selections).

Implementation Details

Vuex Store

• File: client/store/globals.js
• Mutation: addBatchMediaItemsSelected
• Purpose: Efficiently add a large number of items to the selectedMediaItems array without duplicates.

LazyBookshelf Component

• Methods:
  • handleKeyDown(e): Detects the shortcut and calls selectAll().
  • selectAll(): Iterates through loaded entities, builds media item objects, and commits them to the store.
  • mountEntities() Extension: Check isSelectAll flag and auto-select items as they are rendered.
• Events:
  • Listen for keydown on window.
  • Handle bookshelf_clear_selection event to reset isSelectAll flag.

Artifacts

• This specification is saved as artifacts/2026-02-15/select_all.md.