kikootwo
f043688a71
Adds soft-delete support for local users, including backend, API, and UI changes to allow admins to delete local users while preserving their requests. Updates user queries to exclude deleted users and allows username reuse for deleted accounts. Refines search and ranking logic for torrents: uses title-only queries for broader results, increases max results to 100, applies a minimum score threshold (30/100), and logs detailed ranking breakdowns. Updates the ranking algorithm to prioritize title/author match, adjusts scoring weights, and improves BookDate compatibility with Audiobookshelf by disabling rating-based features when unsupported. Enhances file copy operations for large files, improves metadata tagging, and updates documentation to reflect new search and ranking strategies.
3.8 KiB
Prowlarr Integration
Status: ✅ Implemented | Manual search, interactive search, automatic search
Indexer aggregator for searching multiple torrent/usenet indexers simultaneously. Supports manual search, interactive torrent selection, and automatic RSS feed monitoring.
API
Base: http://prowlarr:9696/api/v1
Auth: X-Api-Key header
GET /search?query={q}&categories=3030&indexerIds={ids} - Search indexers (3030 = audiobooks, ids = comma-separated indexer IDs) GET /indexer - List configured indexers GET /indexerstats - Indexer statistics GET /feed/{indexerId}/api?t=search&cat=3030&limit=100 - RSS feed for specific indexer
Search Strategy
Search Query: Title only (not title + author)
- Broader search yields more results (e.g., 20 vs 1)
- Ranking algorithm filters out mismatches using author/narrator
- Works around indexer limitations with complex queries
Extended Search: Enabled (extended=1) - searches title, tags, labels, and metadata fields
Result Filtering:
- Minimum score threshold: 30/100
- Filters applied after ranking to remove poor matches
- maxResults: 100 (increased from 50 for broader search)
Example: "Season of Storms" → finds all "Season of Storms" torrents → ranks by author match → filters score < 30
interface TorrentResult {
indexer: string;
title: string;
size: number; // bytes
seeders: number;
leechers: number;
publishDate: Date;
downloadUrl: string; // magnet or .torrent
infoHash?: string;
guid: string;
format?: 'M4B' | 'M4A' | 'MP3';
bitrate?: string;
hasChapters?: boolean;
}
Config
indexer.prowlarr_urlindexer.prowlarr_api_key
Error Handling
- 401: Invalid API key
- 429: Rate limit (exponential backoff, max 3 retries)
- 503: Service unavailable
- Timeout: 30s per search
Manual & Interactive Search
Indexer Filtering: All searches (manual and interactive) only query indexers enabled in settings (prowlarr_indexers config). If no indexers are enabled, search will fail with error.
Manual Search (POST /api/requests/{id}/manual-search)
- Triggers automatic search job for requests with status: pending, failed, awaiting_search
- Searches only enabled indexers (title only, maxResults: 100)
- Ranks all results, filters scores < 30
- Selects best torrent from filtered results
- Updates request status to 'pending'
Interactive Search (POST /api/requests/{id}/interactive-search)
- Returns ranked torrent results for user selection
- Searches only enabled indexers (title only, maxResults: 100)
- Ranks all results, filters scores < 30
- Shows table with: rank, title, size, quality score, seeders, indexer, publish date
- Available for same statuses as manual search
- User clicks "Download" button to select specific torrent
Select Torrent (POST /api/requests/{id}/select-torrent)
- Downloads user-selected torrent from interactive search
- Triggers download_torrent job
- Updates request status to 'downloading'
UI Integration:
- Manual Search button: Triggers automatic search
- Interactive Search button: Opens modal with torrent results
- Both buttons shown for requests with status: pending, failed, awaiting_search
RSS Monitoring
Automatic Feed Monitoring: Enabled per-indexer via setup wizard or settings page Schedule: Every 15 minutes (default, configurable) Process:
- Fetch RSS feeds from all indexers with RSS enabled
- Fuzzy match results against requests in 'awaiting_search' status
- Trigger search jobs for matches
- Limit: 100 results per feed, 100 missing requests per check
Matching Logic:
- Author name must appear in torrent title
- At least 2 title words (>2 chars) must match
- First match triggers search job (no duplicates)
Tech Stack
- axios
- bottleneck (rate limiting)