Skip to content

connect everything

Plays nicely with the rest of your stack

Marauder doesn't try to replace your torrent client, your notification system, your identity provider, or your indexer. It plugs into them. Here's the integration matrix.

Torrent clients

When a topic updates, Marauder hands the magnet URI or .torrent bytes to one of these clients. The qBittorrent integration is the end-to-end-validated reference path.

qBittorrent

stable

WebUI API v2 — qBittorrent 4.5+ and 5.x.

Transmission

stable

RPC with the X-Transmission-Session-Id 409 dance.

Deluge

stable

Web JSON-RPC at /json. auth.login + web.connect + core.add_torrent_*.

µTorrent

alpha

Token-based WebUI flow. Mocked-server tested.

Download folder

stable

Write the .torrent or .magnet to a folder. Pair with SABnzbd / NZBGet for Usenet.

Notifications

Pick which events fire a notification (topic updated, topic errored, all failures) and which channels they fire on. Mix and match.

Telegram

Bot token + chat ID. Markdown formatting.

Email (SMTP)

STARTTLS + PLAIN auth via net/smtp.

Webhook

POST { source, title, body, link } JSON to any URL.

Pushover

Push notifications to iOS, Android, and desktop via api.pushover.net.

Identity / SSO

Marauder ships with first-class OpenID Connect support. Bring your own provider — Keycloak, Authentik, Authelia, Auth0, Okta, Google, Microsoft Entra, anything that speaks OIDC discovery.

Keycloak (bundled in dev compose)

The docker-compose.sso.yml overlay starts Keycloak 26 with a pre-imported marauder realm and an alice / marauder test user. Click "Sign in with Keycloak" on the login page and you're in.

Full guide: docs/oidc.md

Indexer aggregators

Marauder speaks Torznab and Newznab natively, which means everything in the *arr ecosystem is reachable from a single Marauder instance.

Jackett

~500 tracker definitions wrapped as Torznab. Copy the indexer URL from Jackett and paste it as torznab+https://... in Marauder.

Prowlarr

Indexer manager for the *arr stack. Same flow: copy the Torznab feed URL from any indexer, prefix with torznab+, paste in Marauder.

NZBHydra2

Aggregates Usenet (Newznab) and torrent (Torznab) sources behind one URL. Marauder talks to whichever side you point it at via the newznab+ or torznab+ prefix.

NZBGeek, NZBPlanet, DOGnzb

Direct Newznab indexers. Use the newznab+ prefix and a downloadfolder client pointed at your SABnzbd / NZBGet watch directory.

Full guide: docs/torznab-newznab.md

Observability

Drop Marauder into your existing monitoring stack with zero changes.

Prometheus

/metrics with HTTP, scheduler, tracker, and client collectors. Token-gated for safety.

Loki / Vector

Structured JSON logs via zerolog. Every request gets a request_id for trace correlation.

Health checks

/health and /ready with standard semantics. Both safe for k8s probes and load balancers.