rix1337/docker-quasarr repository overview

Quasarr connects JDownloader with Radarr, Sonarr, Lidarr and LazyLibrarian. It also decrypts 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 discord notification) to solve CAPTCHAs manually. Quasarr will confidently handle the rest. Some CAPTCHA types require Tampermonkey⁠ to be installed in your browser.

⁠Instructions

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

⁠Quasarr

🔗 https://quasarr-host.name⁠ — community guide for finding hostnames

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

⁠JDownloader

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/LazyLibrarian.
• 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/LazyLibrarian.

⁠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

⁠LazyLibrarian

⁠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 'DISCORD'='https://discord.com/api/webhooks/1234567890/ABCDEFGHIJKLMN' \
  -e 'USER'='admin' \
  -e 'PASS'='change-me' \
  -e 'AUTH'='form' \
  -e 'SILENT'='True' \
  -e 'TZ'='Europe/Berlin' \
  ghcr.io/rix1337/quasarr:latest

⁠Manual setup

uv tool install quasarr

export INTERNAL_ADDRESS=http://192.168.0.1:8080
export EXTERNAL_ADDRESS=https://foo.bar/
export DISCORD=https://discord.com/api/webhooks/1234567890/ABCDEFGHIJKLMN
quasarr

• DISCORD see DISCORDdocker variable
• EXTERNAL_ADDRESS see EXTERNAL_ADDRESSdocker variable

⁠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/LazyLibrarian
• Existing settings in JDownloader
• Existing tools from the *arr ecosystem that integrate directly with Radarr/Sonarr/Lidarr/LazyLibrarian

⁠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.
  • A short guide to set up required dev services is found here⁠.
  • 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.
  • Anti-bot measures must be circumvented fully by Quasarr. Thus, you will need to provide a working solution for new CAPTCHA types by integrating it in the Quasarr Web UI. The simplest CAPTCHA bypass involves creating a Tampermonkey user script.
  • 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

⁠🔑 GitHub Auth

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://10.10.0.1:8191/v1' \
  -e 'APIKEY_2CAPTCHA'='your_2captcha_api_key_here' \
  -e 'DEATHBYCAPTCHA_TOKEN'='your_deathbycaptcha_token_here' \
  -e 'TZ'='Europe/Berlin' \
  ghcr.io/rix1337/sponsors-helper:latest