mirror of
https://github.com/kikootwo/ReadMeABook.git
synced 2026-06-03 04:40:09 +00:00
kikootwo
4b90b35748
Extend multi-download-client support to include Transmission and NZBGet and introduce per-client custom download paths. Adds protocol mapping and new client types, Transmission/NZBGet integration services, API CRUD and validation changes, UI components/modal updates and live path previews, and manager routing by protocol. Includes DB migrations (download_path on download_history, interactive_search_access on users), schema updates, and related processor/service fixes and tests to ensure backward compatibility and proper path resolution.
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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 download client (qBittorrent/Transmission/SABnzbd)
|
|
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 or Transmission (torrent), SABnzbd (usenet) — [details](./download-clients.md)
|
|
**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`
|
|
|
|
## Related Docs
|
|
|
|
- [Prowlarr](./prowlarr.md)
|
|
- [Download Clients](./download-clients.md) - Multi-client management, protocol routing
|
|
- [qBittorrent](./qbittorrent.md)
|
|
- [SABnzbd](./sabnzbd.md)
|
|
- [Ranking Algorithm](./ranking-algorithm.md)
|
|
- [File Organization](./file-organization.md)
|
|
- [Plex Integration](../integrations/plex.md)
|