Files
ReadMeABook/documentation/phase3
kikootwo 1afab5d47f Add interactive ebook search & selection
Introduce interactive ebook support: adds two API endpoints to search (interactive-search-ebook) and create/select ebook requests (select-ebook), plus server-side handlers to route Anna's Archive (direct) and indexer (torrent/NZB) downloads. Frontend: extend RequestActionsDropdown and InteractiveTorrentSearchModal to support an "ebook" search mode and selection flow, and add hooks (useInteractiveSearchEbook / useSelectEbook). Settings: add ebook_auto_grab_enabled with UI toggle and enforce disabling when no ebook sources are enabled; settings GET/PUT updated to persist the flag (default = true to preserve behavior). Documentation updated (scheduler, ebook-sidecar, settings pages) and ranking algorithm docs/tests extended to cover ebook-related normalization and matching cases. Includes logging and ranking integration for indexer results and normalization for Anna's Archive handling.
2026-02-02 19:59:58 -05:00
..
2026-01-28 11:41:24 -05:00

Phase 3: Automation Engine

Status: In Development

Multi-stage pipeline transforming requests into downloaded, organized media in Plex.

Pipeline

Request → search_indexers → rank_results → download_torrent
→ monitor_download → process_audiobook → update_plex

Job Types

  1. search_indexers - Search Prowlarr for torrents
  2. rank_results - Apply ranking algorithm, select best
  3. download_torrent - Add to qBittorrent
  4. monitor_download - Poll progress (10s intervals)
  5. process_audiobook - Organize files to media directory
  6. update_plex - Trigger scan, fuzzy match

Integration Points

Indexers: Prowlarr (primary), Jackett (fallback) Download Clients: qBittorrent (primary), Transmission (fallback) Media Server: Plex (scan + match)

Job Queue (Bull)

  • Redis-backed for persistence
  • Retry: 3 attempts, exponential backoff (2s, 4s, 8s)
  • Priorities: High (10), Medium (5), Low (1)
  • Concurrency: 3 concurrent per type
  • Jobs survive app restarts

Config Keys

Prowlarr: indexer.type=prowlarr, indexer.prowlarr_url, indexer.prowlarr_api_key qBittorrent: download_client.type=qbittorrent, download_client.qbittorrent_url/username/password Paths: paths.download_dir, paths.media_dir