Mac-native torrent control for your *arr stack.

Controllarr is a native macOS BitTorrent client and qBittorrent-compatible API target built for Sonarr, Radarr, Overseerr, Plex, and operators who want a Mac mini to behave like a proper media-download node.

Download latest View on GitHub
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

Built for control. Designed for scale.

A focused Mac app for people who want native UI, remote WebUI access, *arr compatibility, VPN-aware torrent traffic, and stability under large libraries.

VPN

VPN-aware routing

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

qBittorrent-compatible API

Point Sonarr, Radarr, and Overseerr at Controllarr using the qBittorrent download-client type. No brittle scraping or custom downloader plugin required.

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

GET /api/v2/torrents/info
1K

Large-library stability

The latest release adds automatic conservative resolver protection for very large libraries so VPN/DNS tracker lookups cannot spike as aggressively.

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

Native Mac + modern WebUI

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

Very large sessions now enter a stricter resolver-protection mode automatically, reducing tracker/DHT fanout and slowing mass reannounce bursts.

Release notes Performance guide
  • 01Large-session resolver guard. 650+ torrent sessions automatically lower tracker, DHT, LSD, and HTTP announce pressure.
  • 02Safer startup restore. Resume directories are scanned before torrents are re-added so protection engages early.
  • 03Slower mass reannounce. Port cycling no longer queues hundreds of tracker DNS lookups in a short burst.
  • 04Direct download. The website button points straight at the current release zip.

Get started in minutes.

Download the latest zip, move the app into Applications, and point your *arr apps at the qBittorrent-compatible API.

1

Download

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

2

Install

Unzip, drag Controllarr.app to /Applications, then right-click and choose Open for first launch if macOS blocks it.

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.

If macOS quarantine gets in the way for your own local install, the install guide includes the same ad-hoc signing pattern used by similar Mac media apps: codesign --force --deep -s - /Applications/Controllarr.app && xattr -rd com.apple.quarantine /Applications/Controllarr.app