Stagearr
From completed torrent to media library, automatically.
Stagearr is a PowerShell post-processing pipeline for qBittorrent. When a torrent finishes, Stagearr takes over: it extracts archives, converts video if needed, handles subtitles, imports the result into Radarr, Sonarr, or Medusa, and sends you an email summary. The whole process is hands-off and resumable across reboots.
How It Works
flowchart LR
A["qBittorrent\nCompletion"] --> B["RAR\nExtract"]
B --> C["Video\nProcess"]
C --> D["Subtitles\nProcessing"]
D --> E["Import\nRadarr / Sonarr / Medusa"]
E --> F["Email\nNotify"]The pipeline runs these phases in order for every job:
- Initialize - load config, create job context, set up logging
- Stage - copy or extract files to a staging folder
- Video - extract from RAR archives, remux MP4 to MKV, strip unwanted subtitle tracks
- Subtitles - extract embedded subtitles, download from OpenSubtitles, clean with SubtitleEdit
- Import - submit to Radarr, Sonarr, or Medusa via ManualImport API; poll for completion
- Notify - write log file, send HTML email notification
Before Stage runs, Stagearr checks for dangerous files (executables, scripts). If any are found, the job is aborted. When the download is still in the Radarr or Sonarr queue, Stagearr also removes and blocklists it to prevent re-download.
What It Does
| Feature | Description |
|---|---|
| RAR Extraction | Automatically extract single and multi-part RAR archives using WinRAR |
| Video Processing | Remux MP4 files to MKV; strip unwanted embedded subtitle tracks |
| Subtitle Handling | Extract tracks from MKV, download from OpenSubtitles, clean up with SubtitleEdit |
| Media Server Import | Full Radarr, Sonarr, and Medusa integration via ManualImport API |
| Email Notifications | Dark-themed HTML emails with configurable subject line templates |
| Metadata Enrichment | Movie posters, IMDb / Rotten Tomatoes / Metacritic ratings in notification emails |
| Job Queue | Persistent file-backed queue; survives reboots and process crashes |
| Safe Processing | Heartbeat-based global lock, path traversal prevention, zip-slip protection |
Documentation Map
| Page | What you will find |
|---|---|
| Installation | Requirements, download, and first-time setup |
| qBittorrent Integration | Configuring qBittorrent to trigger Stagearr on completion |
| Quick Start | Get your first job processed end-to-end |
| Pipeline Overview | Detailed walkthrough of every processing phase |
| Video Processing | RAR extraction, MP4-to-MKV remux, track stripping |
| Subtitle Processing | Extract, download, and clean subtitles |
| Importing | How Radarr, Sonarr, and Medusa imports work |
| Email Notifications | Template syntax, metadata, and preview |
| Configuration Overview | TOML config file structure and sync workflow |
| Settings Reference | Every setting, its default, and what it controls |
| Labels and Content Routing | How download labels map to TV, movie, or passthrough processing |
| CLI Usage | All command-line parameters and modes |
| Job Queue and Locking | Queue states, global lock, multi-machine operation |
| Re-running Jobs | Interactively re-process a recent completed or failed job |
| Auto-Update | Checking for and applying updates |
| Troubleshooting | Common problems, symptoms, and fixes |