Quasarr connects JDownloader with Radarr, Sonarr, Lidarr and Magazarr. It also handles links protected by CAPTCHAs.

Quasarr pretends to be both Newznab Indexer and SABnzbd client. Therefore, do not try to use it with real usenet indexers. It simply does not know what NZB files are.

Quasarr includes a solution to quickly and easily decrypt protected links. Active monthly Sponsors get access to SponsorsHelper to do so automatically. Alternatively, follow the link from the console output (or notification) to solve CAPTCHAs in your browser. This requires Tampermonkey and the matching Quasarr userscript. The CAPTCHA page guides you through installing both once. Solve the CAPTCHA on the crypter's own page and the userscript sends the links back, so Quasarr can confidently handle the rest.

If a link crypter's CAPTCHAs become temporarily unsolvable, you can disable it under Web UI → Link Protection. Affected releases then fail so your *arr app grabs an alternative instead of stalling.

Instructions

1. Set up and run JDownloader 2
2. Configure the integrations below
3. (Optional) Set up flaresolverr-next for sites that require it

Finding your Quasarr URL and API Key
Both values are shown in the console output under API Information, or in the Quasarr web UI.

Quasarr

⚠️ Quasarr requires at least one valid hostname to start. It does not provide or endorse any specific sources, but community-maintained lists are available:

🔗 https://quasarr-hostnames.pages.dev: community guide for finding hostnames

📋 Alternatively, browse community suggestions via pastebin search ( login required).

Authentication is optional but strongly recommended.

• 🔐 Set USER and PASS to enable form-based login (30-day session)
• 🔑 Set AUTH=basic to use HTTP Basic Authentication instead

JDownloader

⚠️ If using Docker: JDownloader's download path must be available to Radarr/Sonarr/Lidarr/Magazarr with identical internal and external path mappings! Matching only the external path is not sufficient.

1. Start and connect JDownloader to My JDownloader
2. Provide your My JDownloader credentials during Quasarr setup

Categories & Mirrors

You can manage categories in the Quasarr Web UI.

• Setup: Add or edit categories to organize your downloads.
• Download Mirror Whitelist:
  • Inside a download category, you can whitelist specific mirrors.
  • If specific mirrors are set, downloads will fail unless the release is available from them.
  • This does not affect search results.
  • This affects the Quasarr Download Client in Radarr/Sonarr/Lidarr and Magazarr.
• Search Hostname Whitelist:
  • Inside a search category, you can whitelist specific hostnames.
  • If specific hostnames are set, only these will be searched by the given search category.
  • This affects search results.
  • This affects the Quasarr Newznab Indexer in Radarr/Sonarr/Lidarr and Magazarr.

Radarr / Sonarr / Lidarr

Add Quasarr as both a Newznab Indexer and SABnzbd Download Client using your Quasarr URL and API Key.

Be sure to set a category in the SABnzbd Download client (default: movies for Radarr, tv for Sonarr and music for Lidarr).

Prowlarr

Add Quasarr as a Generic Newznab Indexer.

• Url: Your Quasarr URL
• ApiKey: Your Quasarr API Key

Magazarr

Magazarr is the magazine companion for Quasarr. It keeps your magazine list, searches Quasarr, sends selected releases to Quasarr for download, imports completed PDFs from JDownloader folders, and serves your library through OPDS.

docker run -d \
  --name="Magazarr" \
  -p 8090:8090 \
  -v /path/to/magazarr-config:/config:rw \
  -v /path/to/magazine-library:/library:rw \
  -v /path/to/jdownloader-output:/output:rw \
  -e 'TZ'='Europe/Berlin' \
  ghcr.io/rix1337/magazarr:latest

Docker

It is highly recommended to run the latest docker image with all optional variables set.

docker run -d \
  --name="Quasarr" \
  -p port:8080 \
  -v /path/to/config/:/config:rw \
  -e 'INTERNAL_ADDRESS'='http://192.168.0.1:8080' \
  -e 'EXTERNAL_ADDRESS'='https://foo.bar/' \
  -e 'USER'='admin' \
  -e 'PASS'='change-me' \
  -e 'AUTH'='form' \
  -e 'TZ'='Europe/Berlin' \
  ghcr.io/rix1337/quasarr:latest

🪟 Windows users: the single quotes above are for Linux/macOS shells. In Windows cmd and PowerShell the quotes are not stripped, so they end up as part of the variable name ('INTERNAL_ADDRESS' instead of INTERNAL_ADDRESS) and Quasarr stops with You must set the INTERNAL_ADDRESS variable.... Drop the single quotes and put everything on one line, e.g. -e INTERNAL_ADDRESS=http://192.168.0.1:8080.

Manual setup

Use this only in case you can't run the docker image.

⚠️ Requires Python 3.12 (or later) and uv!

uv tool install quasarr

export INTERNAL_ADDRESS=http://192.168.0.1:8080
export EXTERNAL_ADDRESS=https://foo.bar/
quasarr

• EXTERNAL_ADDRESS see EXTERNAL_ADDRESS docker variable

Notifications

Configure notifications in Web UI → Notifications Configuration:

• Set provider credentials
• Choose notification types per provider
• Silent notifications won't play any sound

Discord

Telegram

Philosophy

Complexity is the killer of small projects like this one. It must be fought at all cost!

We will not waste precious time on features that will slow future development cycles down. Most feature requests can be satisfied by:

• Existing settings in Radarr/Sonarr/Lidarr/Magazarr
• Existing settings in JDownloader
• Existing tools from the *arr ecosystem that integrate directly with Radarr/Sonarr/Lidarr/Magazarr

Roadmap

• Assume there are zero known issues unless you find one or more open issues in this repository.
• Still having an issue? Provide a detailed report here!
• There are no hostname integrations in active development unless you see an open pull request here.
• Pull requests are welcome! Especially for popular hostnames.
  • Start with AGENTS.md for repository guidelines: development setup, local run commands, tests, linting, and commit/PR conventions. Development environment setup for pull requests also lives in CONTRIBUTING.md.
  • Always reach out on Discord before starting work on a new feature to prevent waste of time.
  • Please follow the existing code style and project structure.
  • CAPTCHA solving for new link crypters is done via Tampermonkey userscripts. You will need to provide a working userscript that integrates with the Quasarr Web UI's CAPTCHA flow.
  • Please provide proof of functionality (screenshots/examples) when submitting your pull request.

SponsorsHelper

SponsorsHelper is a Docker image that solves CAPTCHAs and decrypts links for Quasarr.
The image is public, but requires a valid active monthly GitHub sponsor check at runtime.

🔐 Quasarr API Key Setup

1. Open your Quasarr web UI in a browser
2. On the main page, expand "Show API Settings"
3. Copy the API Key value
4. Use this value for the QUASARR_API_KEY environment variable

Note: The API key is required for SponsorsHelper to communicate securely with Quasarr. Without it, all requests will be rejected with a 401/403 error.

🔑 GitHub Auth

⚠️ Mount /config to persistent storage. Otherwise the auth token is lost on container recreation/update.

1. Start your sponsorship.
2. Start SponsorsHelper.
3. In container logs, open the GitHub authorization URL shown by SponsorsHelper.
4. Confirm the authorization in browser.
5. Done. SponsorsHelper caches the auth token in /config/github_oauth_token.json.

▶️ Run SponsorsHelper

docker run -d \
  --name='SponsorsHelper' \
  -v '/path/to/sponsorshelper-config:/config' \
  -e 'QUASARR_URL'='http://192.168.0.1:8080' \
  -e 'QUASARR_API_KEY'='your_quasarr_api_key_here' \
  -e 'FLARESOLVERR_URL'='http://192.168.0.1:8191/v1' \
  -e 'APIKEY_2CAPTCHA'='your_2captcha_api_key_here' \
  -e 'TZ'='Europe/Berlin' \
  ghcr.io/rix1337/sponsors-helper:latest