A Mac torrent client for Sonarr and Radarr.

Download and manage torrents on your Mac, or connect Sonarr and Radarr to handle downloads for you. Manage transfers in the Mac app or from a browser on your network.

macOS 12+ MIT licensed qBittorrent Web API v2

Session Overview

1,248tracked torrents
712seeding
47tests
8791WebUI/API port
Planet Earth 4KSeeding28.7 GB12 MB/s
The MinistryChecking2.1 GBLAN
Dune Part TwoComplete86.5 GBImported
Foundation S03Downloading12.4 GB215 MB/s

What Controllarr does

Use your VPN for torrent traffic, organize downloads, and connect your media apps.

VPN

Use your VPN for torrent traffic

Bind torrent traffic to the VPN adapter, pause on VPN drops, and keep the WebUI/API listener available for LAN clients when your VPN allows local ingress.

utunadapter watch
LANremote API
Killswitch
qb

Connect Sonarr and Radarr

Add Controllarr as a qBittorrent download client in Sonarr or Radarr. Overseerr sends requests through those apps.

POST /api/v2/torrents/add
category=tv
urls=magnet:?xt=urn:btih:...

GET /api/v2/torrents/info
1K

Manage larger libraries

Controllarr limits how many tracker address lookups run at once when your library gets large.

1,000+torrent guidance
2sfast polling
47tests
UI

Manage downloads locally or in a browser

Use the SwiftUI window on the Mac, the status item in the menu bar, or the embedded React WebUI from another machine on your network.

Local:  http://127.0.0.1:8791
LAN:    http://192.168.1.122:8791
Login:  admin / adminadmin

What's new in the latest release

Version 2.3.0 limits background work, improves VPN startup, fixes import paths, and adds confirmation for bulk removal. It also supports the iOS remote app.

  • 01Background tasks. Saves and archive extraction run in limited batches.
  • 02Torrent controls. VPN connection checks, confirmation before bulk removal, separate download folders, and a tool to repair older folder layouts.
  • 03Remote app for iPhone, iPad, and Mac. Remote 1.1 lets you sort transfers, manage several torrents at once, and inspect files from your iPhone, iPad, or Mac. The Mac download is signed and notarized for Apple Silicon and Intel, macOS 15+. iPhone/iPad build 1.1.0 (3) is in internal TestFlight. See the remote guide for access and notification options.
  • 04Platform guide. Compare Mac and Windows features.

Install and connect

Download the latest zip, move the app into Applications, and point your *arr apps at the Connect Sonarr and Radarr.

1

Download

Download the latest Controllarr-v*-macOS-arm64.zip from GitHub Releases.

2

Install

Unzip, drag Controllarr.app to /Applications, then open it normally.

3

Configure

For LAN clients, set the WebUI bind host to 0.0.0.0, restart, and use the Mac's LAN IP.

4

Connect

Add Controllarr as a qBittorrent client in Sonarr or Radarr at http://mac-lan-ip:8791.

The v2.3.0 Mac release is Developer ID signed, Apple notarized and stapled. No self-signing or quarantine-removal commands are needed. Standard macOS first-launch and network permission prompts can still appear.