Files
ReadMeABook/documentation/phase3
kikootwo a97979358f Implement file hash-based library matching and remove fuzzy ASIN matching
Adds file hash-based matching for Audiobookshelf library items to ensure 100% accurate ASIN assignment for RMAB-organized content. Removes fuzzy matching from library availability checks, making all matching ASIN-only to eliminate false positives and race conditions. Updates database schema, processors, and matcher utilities; adds new tests and documentation for the new matching strategy. Removes obsolete scripts, Dockerfile, and related tests; updates docker-compose for test environments.
2026-01-28 11:42:00 -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