aa-tui

Textual front-end for aa-meta: search Anna's Archive, inspect a result, download it, and edit its metadata.

uv sync
uv run aa-tui ["query"] [--base-url ...] [--cookie ...] [-o DIR]

Results are shown with aa-meta's columns: #, Ext, Title, Author (colour-coded per author), Size, Lang, Year and MD5.

Keys: Enter in the search box searches (a spinner popup shows while waiting; esc cancels); / focuses search; ↑/↓ selects (details load automatically); Enter or a click on a row opens a details popup (e/d work inside it, esc closes); o opens the current search on the site in your browser; d downloads (needs AA_SECRET_KEY or 1Password); q quits (when not typing).

Editing metadata

e opens a form for the highlighted book (title, author, publisher, series, year, language, ISBN, description). ctrl+s saves, esc cancels. Edits are stored per MD5 in ~/.config/aa-tui/metadata.json and shown in the detail pane. When the book has been downloaded, saving also embeds the tags in the file; otherwise they are embedded as soon as it downloads. w re-embeds on demand.

Supported formats: EPUB (OPF Dublin Core + calibre series), PDF (info dictionary), M4B/M4A/MP4 (iTunes atoms), MP3 (ID3v2). Other formats are left untouched with an error notice.

Errors and output

Nothing is printed over the TUI. Anything written to stdout/stderr or logged through loguru (including from aa-meta) appears as a toast: info for stdout and INFO, warning for WARNING, error (shown longer) for stderr and ERROR+. Expected failures (blocked search, API refusals, network errors, unsupported tag formats) are toasts too. An unexpected exception opens a modal with the full traceback instead of quitting; esc closes it.