feat: narrator, series and bitrate columns for MyAnonamouse results

[adman234]

feat: narrator, series and bitrate columns for MyAnonamouse results

Addresses #605 and #934 (narrator in the release list).

Problem

Both requests were closed because the narrator isn't in Torznab results, which is correct. Prowlarr's MyAnonamouse indexer reads author_info but drops the narrator_info and series_info MAM returns next to it, and neither Prowlarr's ReleaseInfo nor the Torznab output has a field for them. Shelfmark's size tooltip already looks for a narrator Torznab attribute, but nothing ever sends one.

When a book has several narrations, choosing one means going back and forth between Shelfmark and the tracker.

Approach

Optional, opt-in enrichment using the user's own MAM session (mam_id), the same approach AudioBookRequest's MAM indexer uses:

1. After the Prowlarr search, releases whose info URL is …myanonamouse.net/t/<id> are collected.
2. Shelfmark sends the same query text to MAM's JSON search (/tor/js/loadSearchJSONbasic.php, normally one request, at most 3), and matches torrents back to Prowlarr's results by torrent ID. The MAM origin is taken from the result URL, so a custom Prowlarr MAM base URL is respected, and the cookie is only ever sent to *.myanonamouse.net.
3. Adds extra.narrator, extra.series (The Sun Eater #1) and extra.bitrate / extra.bitrate_value. MAM has no bitrate field, so it's parsed from the uploader's free-text tags (64 kbps) and some releases won't have one.

Lookups are cached per torrent for an hour, respect the existing Prowlarr search deadline, go through the configured proxy (get_proxies), and never fail the search: a 403, timeout or bad JSON is logged and the list renders without the extra details.

Changes

• release_sources/prowlarr/mam.py (new): small MAM client (search, and get_username for the test button), narrator_info / series_info / tags parsing, cached best-effort lookup_torrent_details(). A 403 includes MAM's reply and a note about the IP/ASN lock.
• release_sources/prowlarr/source.py: enrichment after the result loop. Series, Narrator and Bitrate columns only when a MAM ID is configured, since otherwise they would be empty for every row. A Torznab bitrate attribute from other indexers is also mapped to extra.bitrate.
• release_sources/prowlarr/settings.py: "MyAnonamouse Enrichment" section with PROWLARR_MAM_ID (password field, env-overridable like every setting) and a Test MAM Session button.
• release_sources/__init__.py: ColumnSchema gains optional setting_key and content_types. The new apply_column_visibility() drops gated columns and their grid tracks. Neither field is serialized.
• main.py: /api/releases applies apply_column_visibility() with the request's content type and the user's effective settings.
• config/settings.py / users_settings.py: Search Mode › "Release List Columns" with SHOW_SERIES_COLUMN, SHOW_NARRATOR_COLUMN and SHOW_BITRATE_COLUMN, all default on and user-overridable. Narrator and bitrate are audiobook-only, series shows for both. AudiobookBay's existing bitrate column now follows the bitrate toggle.
• Frontend: text cells truncate with a hover title; the mobile info line wraps and skips empty text/number cells so blank optional columns don't leave orphan · separators; the size tooltip no longer lists Bitrate twice.
• Docs: new docs/myanonamouse-enrichment.md (linked from the index), and a regenerated environment-variables.md. The regeneration also picked up a few pre-existing drifts from main (the Libgen section, AA_DEFAULT_SORT default, a duplicate BOOK_LANGUAGE row). I can drop those if you'd rather keep this diff focused.

⚠️ MAM sessions are IP/ASN-locked

MyAnonamouse locks each session to one IP or ASN. Reusing the session Prowlarr (or a seedbox script) uses will often 403. A separate MAM session for Shelfmark will likely be needed when Shelfmark reaches MAM from a different IP (another host, a VPN container, or a proxy in Shelfmark's Network settings), or when the existing session is ASN-locked to another network. The setting's description, the error message and the new doc all say so.

Testing

• tests/prowlarr/test_mam_enrichment.py (new, 19 tests): parsing (narrator dedupe, multiple series, missing numbers, malformed JSON, tag bitrate), lookup (stops once all IDs are found, cache, 403 and connection errors return empty, expired deadline skips the request), only MAM releases enriched, Torznab bitrate mapping, column config with and without a MAM ID for audiobook and ebook, toggles, grid-track removal, and gates not serialized.
• tests/core/test_admin_users_api.py: the curated search-preference key list now includes the three toggles.
• Full pytest -m "not integration and not e2e" compared with an upstream main worktree on the same machine: no new failures. The remaining ~115 failures on both are Windows-only (tor/entrypoint shell tests, path separators).
• ruff check / ruff format --check / basedpyright (0 errors) / vulture on touched files; frontend tsc --noEmit, oxlint, oxfmt --check, vitest (201 passed).
• Manually verified with a real MAM account on a Docker build of this branch: the test button, then narrator, series and bitrate on MyAnonamouse audiobook results.

No behavior change unless PROWLARR_MAM_ID is set, apart from the bitrate toggle on AudiobookBay (default on, same as today).

🤖 Generated with Claude Code

[calibrain]

Thank you !

[mikaeltarquin]

Can this now be used to add a {Narrator} text field to the download path? I am trying to get audiobooks to download to “/{Author}/{Title} {{Narrator}}/{Title}” so that I can have multiple versions of the same book without having to manually rename folders each time.

[adman234]

Can this now be used to add a {Narrator} text field to the download path? I am trying to get audiobooks to download to “/{Author}/{Title} {{Narrator}}/{Title}” so that I can have multiple versions of the same book without having to manually rename folders each time.

Good idea, I've created a new PR for this change.

#1407