SponsorsHelper
Docker app from rix's Repository
SponsorsHelper is a Docker image that solves CAPTCHAs and decrypts links for Quasarr.
Requirements
Overview
Readme
View on GitHub
Quasarr connects JDownloader with Radarr, Sonarr, Lidarr and Magazarr. It reads download sites, offers their releases to your apps and sends the ones they pick to JDownloader, including links protected by CAPTCHAs.
PyPI version SimpleX Community GitHub Sponsorship
To your apps, Quasarr looks like a Newznab Indexer and a SABnzbd client. It does not work with real usenet
indexers and does not know what NZB files are.
Getting started
- Set up and run JDownloader 2.
- Run Quasarr, preferably with Docker.
- Open the web UI and follow the setup: My JDownloader login, then at least one site.
- Add Quasarr to Radarr, Sonarr and Lidarr, Prowlarr or Magazarr.
- Optional: set up flaresolverr-next for sites that show a browser check.
Finding your Quasarr URL and API key Both are shown in the console output under API Information and in the web UI.
Authentication is optional but strongly recommended.
- 🔐 Set
USERandPASSto enable form-based login (30-day session).- 🔑 Set
AUTH=basicto use HTTP Basic Authentication instead.
Sites
Quasarr needs at least one site to start. It does not provide or endorse any sources.
Adding sites
Paste the hostnames you use under Sites in the web UI, one per line, or load a list from a URL. Lines such as
xy = example.org from community lists work too. Quasarr opens each site, tells you which built-in template matches it
and adds them in one go. Sites that need your login ask for it right in the list.
Community-maintained lists help you find hostnames:
🔗 https://quasarr-hostnames.pages.dev: community guide for finding hostnames
📋 Community suggestions via pastebin search (login required).
Sites without a matching template
When no built-in template matches a hostname, Quasarr says so and offers Set it up yourself: a guided setup for experienced users that works on desktop and phones and needs no code.
- Site: hostname, a name and the language of its releases, read from the site. You can also import a template someone shared.
- Feed: Quasarr finds the page for each kind in the site menu, uses its RSS feed when the page offers one, picks the release block and the release name, link, size and date, and tests every page. A kind that reads nothing is left out. A preview shows what it read; pick a dropdown entry or click the page to change it.
- Search: Quasarr finds the site's search and tests it with each kind's newest release, by IMDb ID or, when the site cannot find IDs, by title. Results that only link posts are opened, and a kind the found search cannot find tries its own section and the site's other search addresses. Results laid out differently from the feed get their own fields.
- Downloads: Quasarr opens a release page and frames its download or crypter links. When there are none, the site needs a userscript.
- Save: a summary of everything set up, with each kind's search test, and the template to export.
Every step has a test that runs the same code Quasarr uses for your apps, so you see the releases and links before saving.
Sites that need a login cannot be set up this way. They need Python code, contributed as a pull request.
A site you set up yourself is yours to maintain. Issues about it are not supported.
Links that only appear in a browser
Some sites show their download links only after a CAPTCHA or a click. In the downloads step you can hand such release pages to a userscript you write: when your app grabs a release, the CAPTCHA page opens it in your browser and your script sends the links back.
Install Tampermonkey first, then the userscript template the setup links to. The template does not work out of the box. It only connects the page to Quasarr, and you add the code that finds the links. Unlike the shipped userscripts it is not obfuscated, so you can read and extend it. It never updates itself, so your code stays. Do not change the part marked as the Quasarr connection.
Share a site
Once a site of your own reads its newest releases and finds what you search for, Share on the sites page turns it into a template. The hostname is never part of it. Others can import it under Set it up yourself. If it runs stable for you, please open a pull request with it, so the site becomes built-in for everyone.
Changing a built-in site
When a site changes and an update is not out yet, experienced users can change its template under Sites → Edit. It opens in the same editor as sites you set up yourself, with each step tested before you save, and its template as JSON on the last step. Steps a site runs in Quasarr's own code cannot change; you can change the addresses that code requests.
A changed site is yours to maintain. Issues about it are not supported, so reset it to the shipped version before you report a problem. A changed site is reset, not removed.
Hostname rules
Quasarr refuses hostnames of link protection services (such as FileCrypt) and file hosters. Those are where downloads end up, not sites that list releases.
Sites behind a browser check are loaded through FlareSolverr when it is set up. Quasarr passes the check once per site and reuses it, so FlareSolverr only steps in again when the check expires.
CAPTCHAs and protected links
Quasarr includes a way to quickly decrypt protected links. Active monthly sponsors get access to SponsorsHelper to do so automatically. Otherwise, follow the link from the console output or a notification and solve the CAPTCHA in your browser.
This needs Tampermonkey and the matching Quasarr userscript; the CAPTCHA page guides you through installing both once. You solve the CAPTCHA on the crypter's own page, and the userscript sends the links back to Quasarr. The shipped userscripts are obfuscated, which makes it harder for crypters to detect and block them.
If a crypter stops working for a while, switch it off under Web UI → Crypter Kill Switches. New grabs that only have links from it then fail, so your app can try another release instead of stalling.
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 enough.
- Start JDownloader and connect it to My JDownloader.
- Enter your My JDownloader credentials during Quasarr setup.
Fresh install recommended
Consider a fresh JDownloader instance. Quasarr changes JDownloader's settings for the Radarr/Sonarr/Lidarr/Magazarr integration.
Categories and mirrors
Manage categories in the web UI.
- Download categories organize your downloads. Inside one you can allow only certain mirrors: downloads then fail unless the release is available from them. Every allowed mirror is used; their order sets the priority, so the first one comes first, as when solving a CAPTCHA. This affects the Quasarr download client in your apps, not search results.
- Search categories can be limited to certain sites. Only those sites are then searched for that category. This affects the Quasarr Newznab indexer in your apps.
Radarr / Sonarr / Lidarr
Add Quasarr as both a Newznab Indexer and a SABnzbd Download Client with your Quasarr URL and API key.
Set a category in the SABnzbd Download Client (default: movies for Radarr, tv for Sonarr and music for
Lidarr).
Show download status in Radarr/Sonarr/Lidarr
Activity → Queue → Options → enable Release Title.
Prowlarr
Add Quasarr as a Generic Newznab Indexer.
- Url: your Quasarr URL
- ApiKey: your Quasarr API key
Allowed search parameters and categories
Movies / TV
- Search by IMDb ID, syntax
{ImdbId:tt0133093}, with category2000(Movies) or5000(TV). - Plain text search is not supported.
Music / Books / Magazines
- Plain text search with category
3000(Music) or7000(Books/Magazines).
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.
Configure Magazarr
Run Magazarr and open http://127.0.0.1:8090:
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
Set these values in Magazarr:
| Setting | Value |
|---|---|
| Quasarr URL | Your Quasarr URL |
| Quasarr API Key | Your Quasarr API key |
| Search category | 7000 |
| Download category | docs |
| JDownloader import root | /output, or the same internal path where completed JDownloader packages are visible |
| Library directory | /library, or wherever Magazarr should store imported PDFs |
Magazarr imports the PDF and cleans up the completed package folder.
Docker
Run the latest 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
| Parameter | Description |
|---|---|
INTERNAL_ADDRESS |
Required. Internal URL so Radarr/Sonarr/Lidarr/Magazarr can reach Quasarr. Include the port. |
EXTERNAL_ADDRESS |
Optional. External URL, for example behind a reverse proxy. Always protect it with authentication. |
USER / PASS |
Optional, but recommended. Username and password for the web UI. |
AUTH |
Authentication mode: form or basic. |
TZ |
Timezone. A wrong value can cause HTTPS/SSL errors. |
Keep /config on persistent storage. It holds your settings, including your own sites.
Manual setup
Only use this if 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 works as described for Docker.
Notifications
Quasarr notifies you through Discord, Telegram or Pushover. Configure them under Web UI → Notifications Configuration: set provider credentials and choose which notifications each provider gets. Silent notifications play no sound.
Discord
Configure Discord
- In your Discord server, open Server Settings → Integrations → Webhooks.
- Click New Webhook, choose the target channel and copy the Webhook URL.
- In Quasarr, open Notifications.
- Paste the webhook URL into Discord → Webhook URL.
- Click Save Notification Settings, then Send Discord Test.
Telegram
Configure a Telegram bot
- Create a bot: in Telegram, open @BotFather, send
/newbotand follow the prompts. - Copy the token: BotFather replies with an HTTP API token (e.g.
123456789:ABCdefGHI...). This is yourTELEGRAM_BOT_TOKEN. - Start a chat with the bot: send it any message (e.g.
/start) so it can message you back. - Get your chat ID: open this URL in a browser, with
<TOKEN>replaced by your bot token:
The number afterhttps://api.telegram.org/bot<TOKEN>/getUpdates"chat":{"id":is yourTELEGRAM_CHAT_ID.Tip: for a group chat, add the bot to the group, send a message there, then call
getUpdates. - In Quasarr, open Notifications.
- Paste both values into Telegram → Bot Token / Chat ID.
- Click Save Notification Settings, then Send Telegram Test.
Pushover
Configure Pushover
Pushover sends notifications to its iOS, Android and desktop apps. After a 30-day trial, each platform needs a one-time purchase. Up to 10,000 messages a month are free.
- Get your user key: sign up at pushover.net, log in and copy the User Key shown on your dashboard. To notify several people, create a group in Pushover and use its group key instead.
- Register an application: open pushover.net/apps/build, name it
Quasarr(an icon is optional), accept the terms and copy the application's API token. - Install the Pushover app on your phone or computer and log in, so the device receives messages.
- In Quasarr, open Notifications.
- Paste the values into Pushover → Application API Token and User or Group Key. Both are 30 letters and digits.
- Click Save Notification Settings, then Send Pushover Test.
Notifications arrive with their links, and with the poster when one is available. Silent notifications use Pushover's lowest priority: they show up in the app without a sound or an alert. The notice that SponsorsHelper was switched off uses high priority, so it sounds even during quiet hours.
Philosophy
Complexity is the killer of small projects like this one. It must be fought at all cost.
We do not spend time on features that slow future development down. Most feature requests are already covered by:
- settings in Radarr/Sonarr/Lidarr/Magazarr
- settings in JDownloader
- tools from the *arr ecosystem that integrate directly with Radarr/Sonarr/Lidarr/Magazarr
Contributing
- Assume there are no known issues unless an issue is open in this repository.
- Still stuck? File a detailed report here. Reports about built-in sites you changed or sites you set up yourself are not supported.
- No site integration is in development unless a pull request is open.
- Pull requests are welcome, especially for popular sites:
- The easiest way to add a site is to set it up yourself and share it as a template.
- Sites that need a login, an API or other code ship as a template package: the template plus the site's search and download modules beside it, which read the site's addresses from the template.
- Start with AGENTS.md for repository guidelines: development setup, local run commands, tests, linting and commit/PR conventions. Development environment setup also lives in CONTRIBUTING.md.
- Reach out on SimpleX before starting work on a new feature.
- Follow the existing code style and project structure.
- CAPTCHA solving for new link crypters runs through Tampermonkey userscripts. Provide a working userscript that integrates with the CAPTCHA flow of the Quasarr web UI.
- Show that it works (screenshots or examples) in 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.
Crypters change their CAPTCHAs all the time, so SponsorsHelper needs constant upkeep. The recurring monthly sponsorship
pays for that upkeep, which is why the check looks for an active one rather than a one-time payment.
🔐 Quasarr API Key Setup
- Open your Quasarr web UI in a browser
- On the main page, expand "Show API Settings"
- Copy the API Key value
- Use this value for the
QUASARR_API_KEYenvironment 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
/configto persistent storage. Otherwise the auth token is lost on container recreation/update.
- Start your sponsorship.
- Start SponsorsHelper.
- In container logs, open the GitHub authorization URL shown by SponsorsHelper.
- Confirm the authorization in browser.
- 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
| Parameter | Description |
|---|---|
QUASARR_URL |
Local URL of Quasarr (e.g., http://192.168.0.1:8080) |
QUASARR_API_KEY |
Your Quasarr API key (found in Quasarr web UI under "API Settings") |
FLARESOLVERR_URL |
Local URL of flaresolverr-next |
APIKEY_2CAPTCHA |
2Captcha account API key |
TZ |
Timezone for SponsorsHelper (e.g., Europe/Berlin) |
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/rix1337/sponsors-helper:latestRuntime arguments
- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--log-opt max-size=50m
Template configuration
Persistent SponsorsHelper state including cached GitHub auth token.
- Target
- /config
- Default
- /mnt/user/appdata/sponsorshelper
- Value
- /mnt/user/appdata/sponsorshelper
Local URL of Quasarr including protocol and port (for example http://192.168.0.1:8080).
- Target
- QUASARR_URL
- Default
- http://192.168.0.1:8080
- Value
- http://192.168.0.1:8080
Required API key from Quasarr web UI under Show API Settings.
- Target
- QUASARR_API_KEY
Required API key for 2Captcha service. https://2captcha.com/?from=27506687
- Target
- APIKEY_2CAPTCHA
Optional token for DeathByCaptcha service.
- Target
- DEATHBYCAPTCHA_TOKEN
Local URL of FlareSolverr endpoint (for example http://10.10.0.1:8191/v1).
- Target
- FLARESOLVERR_URL
- Default
- http://10.10.0.1:8191/v1
- Value
- http://10.10.0.1:8191/v1
Optional timezone (for example Europe/Berlin).
- Target
- TZ
- Default
- Europe/Berlin