Library Management
The Books view (#/) is your home library — every book you've uploaded,
grouped by author and then by series, with search, tags, and a status filter
on top. It has two presentations, toggled by the Cards / Table control in
the top-right: card view (a visual grid, good for browsing covers) and table
view (dense rows, good for scanning many books at once). Both read the same
underlying data and stay in sync with each other.
The header shows your workspace's on-disk root (with a one-click Copy),
four running totals (books, total runtime, distinct voices, in-progress
count), a search box (matches title or author), and a status filter (All /
In progress / Complete). Every book also carries a tags array — once a
book has tags, a chip row appears under the search box (below, series-1)
and clicking a chip ANDs it into the current filter; a library with no
tagged books simply doesn't render the row, rather than showing it empty. A
second chip row appears whenever the library spans more than one language —
English, Deutsch, Русский below — and ANDs into the same filter.
Each book carries a status badge tracking where it is in the pipeline: Ready to analyse, Analysing, Cast confirmation (waiting for you to confirm the detected cast), Cast ready, Generating, and Complete. Cast ready is the step between confirming a cast and rendering it — the cast is locked but no audio has been generated yet, so the book is still designing (or waiting on) voices; opening it lands on the Cast view rather than the Generate tab, and it counts under the header's In progress total right alongside Generating.
Every book belongs to a series — or, if it's a standalone, to a synthetic
"Standalones" group. The table view makes this grouping the most
explicit: each series gets its own collapsible section (a chevron toggle plus
a live book count and its own status/runtime/characters/voices columns), with
a "Standalones" pseudo-section collecting every standalone book across
every author into one place at the bottom. Below, a four-book series —
The Hollow Tide, by Marin Vale — shows exactly this: each entry numbered
(#1–#4) with its own status (Complete, Generating, Analysing, Cast
confirmation), next to three standalones (English, Russian, German) in their
own section underneath. The card view shows the same grouping as a plain
section heading rather than a collapsible one.
Once you've listened across multiple books in a series, a Series Memory chip appears next to the section header, summarising which characters' voices have carried through from one book to the next — the continuity Reviewing Cast & Assigning Voices talks about, made visible on the shelf.
The plan for this page originally called for a screenshot of a book
bundle — multiple books grouped or packaged together. That feature doesn't
exist anywhere in the app today. The one feature that uses the word "bundle"
is Import portable bundle (visible in the top-right of the screenshot
above) — it imports a single book's .portable.zip export (manuscript +
state + cast + audio) from another machine, not a multi-book package. A
follow-up issue is filed to resolve the naming mismatch between this plan and
the shipped feature set (see #1294);
this sub-section is intentionally omitted rather than describing a screenshot
that doesn't exist.
Every book card (or table row) has a kebab menu with Edit details, Find cover image, Re-parse manuscript, Replace manuscript…, and Delete book. Re-parsing and replacing both discard cached analysis, cast, and any generated audio — you'll confirm the cast again afterwards — while the manuscript file itself (re-parse) or its replacement (replace) stays on disk. Deleting a book removes its whole directory, including listening history and stats, and can't be undone.