quasarr 1.26.7__py3-none-any.whl → 1.27.0__py3-none-any.whl

{quasarr-1.26.7.dist-info → quasarr-1.27.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quasarr
-Version: 1.26.7
+Version: 1.27.0
 Summary: Quasarr connects JDownloader with Radarr, Sonarr and LazyLibrarian. It also decrypts links protected by CAPTCHAs.
 Home-page: https://github.com/rix1337/Quasarr
 Author: rix1337
@@ -44,97 +44,115 @@ Alternatively, follow the link from the console output (or discord notification)
 Quasarr will confidently handle the rest. Some CAPTCHA types require [Tampermonkey](https://www.tampermonkey.net/) to be installed in your browser.
 
 # Instructions
-1. Set up and run [FlareSolverr 3](https://github.com/FlareSolverr/FlareSolverr).
-2. Set up and run [JDownloader 2](https://jdownloader.org/download/index).
-3. Follow the next steps.
+
+1. Set up and run [FlareSolverr 3](https://github.com/FlareSolverr/FlareSolverr)
+2. Set up and run [JDownloader 2](https://jdownloader.org/download/index)
+3. Configure the integrations below
+
+> **Finding your Quasarr URL and API Key**  
+> Both values are shown in the console output under **API Information**, or in the Quasarr web UI.
 
 ---
 
 ## FlareSolverr
-1. Ensure your running FlareSolverr is reachable by Quasarr.
-2. Provide your FlareSolverr URL to Quasarr during the setup process.
-3. The full URL must include the version path, e.g., `http://192.168.1.1:8191/v1`.
+
+Provide your FlareSolverr URL during setup. Include the version path:
+```
+http://192.168.1.1:8191/v1
+```
 
 ---
 
 ## Quasarr
 
-Tell Quasarr which sites to search for releases. It requires at least one valid source to start up.
+> ⚠️ Quasarr requires at least one valid hostname to start. It does not provide or endorse any specific sources, but community-maintained lists are available:
+
+🔗 **[quasarr-hostnames.pages.dev](https://quasarr-hostnames.pages.dev)** — third-party guide for finding hostnames
 
-> - By default, Quasarr does **not** know which sites to scrape for download links.  
-> - The setup will guide you through the process of providing valid hostnames for Quasarr to scrape.  
-> - Do **not** ask for help here if you do not know which hostnames to use. Picking them is solely your responsibility.  
-> - You may check sites like [Pastebin](https://pastebin.com/search?q=hostnames+quasarr) for user‑submitted suggestions.
+📋 Alternatively, browse community suggestions via [pastebin search](https://pastebin.com/search?q=hostnames+quasarr) (login required).
 
 ---
 
 ## JDownloader
 
-1. Ensure your running JDownloader is connected to the My JDownloader service.  
-2. Provide your [My‑JDownloader‑Credentials](https://my.jdownloader.org) to Quasarr during the setup process.
+> ⚠️ If using Docker: 
+> JDownloader's download path must be available to Radarr/Sonarr/LazyLibrarian with **identical internal and external path mappings**!
+> Matching only the external path is not sufficient.
 
-> - Consider setting up a fresh JDownloader before you begin.  
-> - JDownloader must be running and available to Quasarr.  
-> - Quasarr will modify JDownloader’s settings so downloads can be handled by Radarr/Sonarr/LazyLibrarian.  
-> - If using Docker, ensure that JDownloader’s download path is available to Radarr/Sonarr/LazyLibrarian with **exactly the same** internal and external path mapping (matching only the external path is not enough).
+1. Start and connect JDownloader to [My JDownloader](https://my.jdownloader.org)
+2. Provide your My JDownloader credentials during Quasarr setup
+
+<details>
+<summary>Fresh install recommended</summary>
+
+Consider setting up a fresh JDownloader instance. Quasarr will modify JDownloader's settings to enable Radarr/Sonarr/LazyLibrarian integration.
+
+</details>
 
 ---
 
 ## Radarr / Sonarr
 
-Set up Quasarr as a **Newznab Indexer** and **SABnzbd Download Client**:
+> ⚠️ **Sonarr users:** Set all shows (including anime) to the **Standard** series type. Quasarr cannot find releases for shows set to Anime/Absolute.
+
+
+Add Quasarr as both a **Newznab Indexer** and **SABnzbd Download Client** using your Quasarr URL and API Key.
+
+<details>
+<summary>Show download status in Radarr/Sonarr</summary>
 
-1. **URL**: Use the `URL` from the **API Information** section of the console output (or copy it from the Quasarr web UI).  
-2. **API Key**: Use the `API Key` from the **API Information** section of the console output (or copy it from the Quasarr web UI).  
-3. Leave all other settings at their defaults.
+**Activity → Queue → Options** → Enable `Release Title`
 
-> **Important notice for Sonarr**  
-> - Ensure all shows (including anime) are set to the **Standard** series type.  
-> - Quasarr will never find releases for shows set to **Anime / Absolute**.
+</details>
+
+<details>
+<summary>Restrict results to a specific mirror</summary>
+
+Append the mirror name to your Newznab URL:
+```
+/api/dropbox/
+```
+Only releases with `dropbox` in a link will be returned. If the mirror isn't available, the release will fail.
+
+</details>
 
 ---
 
 ## LazyLibrarian
 
-> **Important notice**
-> - This feature is experimental and may not work as expected.
-> - Quasarr cannot help you with metadata issues, missing covers, or other LazyLibrarian problems.
-> - Please report issues when one of your hostnames yields results through their website, but not in LazyLibrarian.
-
-Set up Quasarr as a **SABnzbd+ Downloader**
+> ⚠️ **Experimental feature** — Report issues when a hostname returns results on its website but not in LazyLibrarian.
 
-1. **SABnzbd URL/Port**: Use port and host parts from `URL` found in the **API Information** section of the console output (or copy it from the Quasarr web UI).  
-2. **SABnzbd API Key**: Use the `API Key` from the **API Information** section of the console output (or copy it from the Quasarr web UI).  
-3. **SABnzbd Category**: Use `docs` to ensure LazyLibrarian does not interfere with Radarr/Sonarr.  
-4. Press `Test SABnzbd` to verify the connection, then `Save changes`.
+<details>
+<summary>Setup instructions</summary>
 
-Set up Quasarr as a **Newznab Provider**:
-1. **Newznab URL**: Use the `URL` from the **API Information** section of the console output (or copy it from the Quasarr web UI).
-2. **Newznab API** Use the `API Key` from the **API Information** section of the console output (or copy it from the Quasarr web UI).
-3. Press `Test` to verify the connection, then `Save changes`.
+### SABnzbd+ Downloader
 
-Fix the `Importing` settings:
-1. Check `Enable OpenLibrary api for book/author information`
-2. Select `OpenLibrary` below `Primary Information Source`
-2. Under `Import languages` add `, Unknown` (and for German users: `, de, ger, de-DE`).
+| Setting | Value |
+|---------|-------|
+| URL/Port | Your Quasarr host and port |
+| API Key | Your Quasarr API Key |
+| Category | `docs` |
 
-Fix the `Processing` settings:
-1. Under `Folders` add the full Quasarr download path, typically `/downloads/Quasarr/`
-2. If you do not do this,  processing after the download will fail.
+### Newznab Provider
 
+| Setting | Value |
+|---------|-------|
+| URL | Your Quasarr URL |
+| API | Your Quasarr API Key |
 
+### Fix Import & Processing
 
----
+**Importing:**
+- Enable `OpenLibrary api for book/author information`
+- Set Primary Information Source to `OpenLibrary`
+- Add to Import languages: `, Unknown` (German users: `, de, ger, de-DE`)
 
-## Advanced Settings
+**Processing → Folders:**
+- Add your Quasarr download path (typically `/downloads/Quasarr/`)
 
-To restrict results to a specific mirror, add the mirror name to the Newznab/indexer URL.  
-> **Example:** Appending `/api/dropbox/` will only return releases where `dropbox` is explicitly mentioned in a link.  
-> **Caution:** If a mirror is not available at a hostname, the release will be ignored or the download will fail. Use this option carefully.
+</details>
 
-To see download status information in Radarr/Sonarr
-1. Open `Activity` → `Queue` → `Options`
-2. Enable `Release Title`
+---
 
 # Docker
 
@@ -173,8 +191,6 @@ Use this only in case you can't run the docker image.
 `pip install quasarr`
 
 * Requires Python 3.12 or later
-* Requires [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr)
-* Requires [JDownloader 2](https://jdownloader.org/download/index) with [My JDownloader](https://my.jdownloader.org/)
 
 ```
   --port=8080
@@ -205,10 +221,11 @@ Most feature requests can be satisfied by:
 - Still having an issue? Provide a detailed report [here](https://github.com/rix1337/Quasarr/issues/new/choose)!
 - There are no hostname integrations in active development unless you see an open pull request
   [here](https://github.com/rix1337/Quasarr/pulls).
-- Pull requests are welcome. Especially for popular hostnames.
+- **Pull requests are welcome!** Especially for popular hostnames.
+    - A short guide to set up required dev services is found in [/docker/dev-setup.md](https://github.com/rix1337/Quasarr/blob/main/docker/dev-setup.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.
-    - Anti-bot measures must be circumvented fully by Quasarr. Thus you will need to provide a working solution for new
+    - 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.
     - Please provide proof of functionality (screenshots/examples) when submitting your pull request.
 
@@ -238,6 +255,8 @@ Image access is limited to [active monthly GitHub sponsors](https://github.com/u
 
 ## 🐋 Docker Login
 
+⚠️ **Before logging in, the image will not download.**
+
 ```bash
 echo "GITHUB_TOKEN" | docker login ghcr.io -u USERNAME --password-stdin
 ````
@@ -245,14 +264,10 @@ echo "GITHUB_TOKEN" | docker login ghcr.io -u USERNAME --password-stdin
 * `USERNAME` → your GitHub username
 * `GITHUB_TOKEN` → the token you just created
 
----
-
-⚠️ **Before logging in, the image will not download.**
-
----
-
 ## ▶️ Run SponsorsHelper
 
+⚠️ **Without a valid GitHub token linked to an active sponsorship, the image will not run.**
+
 ```bash
 docker run -d \
   --name='SponsorsHelper' \
@@ -268,8 +283,6 @@ docker run -d \
   ghcr.io/rix1337-sponsors/docker/helper:latest
 ```
 
-### Required Parameters
-
 * `QUASARR_URL` → Local URL of Quasarr
 * `DEATHBYCAPTCHA_TOKEN` → [DeathByCaptcha](https://deathbycaptcha.com/register?refid=6184288242b) account token
 * `GITHUB_TOKEN` → Classic GitHub PAT with the scopes listed above
@@ -277,30 +290,3 @@ docker run -d \
 * `NX_USER` / `NX_PASS` → NX account credentials
 * `JUNKIES_USER` / `JUNKIES_PASS` → Junkies account credentials
 * `JUNKIES_HOSTER` → Preferred hoster for Junkies links
----
-
-⚠️ **Without a valid GitHub token linked to an active sponsorship, the image will not run.**
-
----
-
-# Development Setup for Pull Requests
-
-To test your changes before submitting a pull request:
-
-**Run Quasarr with the `--internal_address` parameter:**
-
-```bash
-python Quasarr.py --internal_address=http://<host-ip>:<port>
-```
-
-Replace `<host-ip>` and `<port>` with the scheme, IP, and port of your host machine.
-The `--internal_address` parameter is **mandatory**.
-
-**Start the required services using the `dev-services-compose.yml` file:**
-
-```bash
-CONFIG_VOLUMES=/path/to/config docker-compose -f docker/dev-services-compose.yml up
-```
-
-Replace `/path/to/config` with your desired configuration location.
-The `CONFIG_VOLUMES` environment variable is **mandatory**.

{quasarr-1.26.7.dist-info → quasarr-1.27.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
-quasarr/__init__.py,sha256=u-aOsfvCuLh2J0pIBFlTO-IPZQFwxTcqy-mDpl1sY-s,17399
+quasarr/__init__.py,sha256=6-6FpRbLyr_DXpNTlXkzQAPnDxboMkHKvkhlmyP632Q,13593
 quasarr/api/__init__.py,sha256=9Y_DTNYsHeimrXL3mAli8OUg0zqo7QGLF2ft40d3R-c,6822
 quasarr/api/arr/__init__.py,sha256=6CFASudVLlqKVNhTnS72Np2T3uAMsJXE-8u0986WW9c,17460
 quasarr/api/captcha/__init__.py,sha256=IhJVn9iWtb01P2yfoqtOF7wSsiXizES7HNn29BX1uHk,60268
-quasarr/api/config/__init__.py,sha256=0K7zqC9dt39Ul1RIJt0zNVdh1b9ARnfC6QFPa2D9FCw,819
+quasarr/api/config/__init__.py,sha256=hUPDhGDyLe3DhzEl6mK5iBf8FDRu-9bNSjEnECsNXkY,5163
 quasarr/api/sponsors_helper/__init__.py,sha256=kAZabPlplPYRG6Uw7ZHTk5uypualwvhs-NoTOjQhhhA,6369
 quasarr/api/statistics/__init__.py,sha256=NrBAjjHkIUE95HhPUGIfNqh2IqBqJ_zm00S90Y-Qnus,7038
 quasarr/downloads/__init__.py,sha256=bpNg6LNqoqpnA-U7uVDhq9jM6VYB2bkekCw1XxZRpWM,11613
@@ -39,13 +39,14 @@ quasarr/providers/notifications.py,sha256=bohT-6yudmFnmZMc3BwCGX0n1HdzSVgQG_LDZm
 quasarr/providers/obfuscated.py,sha256=xPI3WrteOiZN5BgNDp0CURcYfkRrdnRCz_cT7BpzIJU,1363310
 quasarr/providers/shared_state.py,sha256=-TIiH2lkCfovq7bzUZicpUjXEjS87ZHCcevsFgySOqw,29944
 quasarr/providers/statistics.py,sha256=cEQixYnDMDqtm5wWe40E_2ucyo4mD0n3SrfelhQi1L8,6452
-quasarr/providers/version.py,sha256=8oDNDlpJxRsfDR0RSzNNJkrCTQ-lnpN8coFtTqgMASY,4004
+quasarr/providers/utils.py,sha256=CEBsrtuasrQ8-l535Va4S_7gT9N47qjjgOKYGJX0TE0,5095
+quasarr/providers/version.py,sha256=pwciXHt2xf8Tbxgm6j1ZZ_-zwPJuduxnv-hGwn0wbjM,4004
 quasarr/providers/web_server.py,sha256=AYd0KRxdDWMBr87BP8wlSMuL4zZo0I_rY-vHBai6Pfg,1688
 quasarr/providers/sessions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-quasarr/providers/sessions/al.py,sha256=F1d76eAJcbTvb6YvAIlQ4gfrYC_256QAKiWEQcuWe8k,10612
-quasarr/providers/sessions/dd.py,sha256=JdXjqmjuyY32w0cIlwphRm8Sy43EK8nEEFwyXUkEGb4,2596
-quasarr/providers/sessions/dl.py,sha256=8toAHn5C9FbjHuhjfQEeKR1Fz5tRENrIgFxdjUuXCIU,5381
-quasarr/providers/sessions/nx.py,sha256=qfW12AB_0nNsAoKOaSF4z0T9DCxMQleWCYf3fqJtF2A,2688
+quasarr/providers/sessions/al.py,sha256=ARNgWAhTKQhAz0mF8kB2OsT8bGcC-mmYF-Wd22to-wA,11346
+quasarr/providers/sessions/dd.py,sha256=I9tQCdxmhtbdmRUhKlkM1ZJjja1N1bdRSEZdfbSRWkc,2832
+quasarr/providers/sessions/dl.py,sha256=6tch4QzkdwbU6XoNQE22T5nz5eoKlBVGa0eyjXJHPyA,5574
+quasarr/providers/sessions/nx.py,sha256=vZDVnu4sKizx1wyKmrTr8itGURSEIVOtzMI5efjF6Oo,2924
 quasarr/search/__init__.py,sha256=V59LIiC75mQvasDdTjiWZRbPD1jXO1lhXlKeNVX0iOc,5726
 quasarr/search/sources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 quasarr/search/sources/al.py,sha256=yr6wx-VcSOFYK_o3N1bepC4t6Gvt9eDvcG9fQBFg0bg,17203
@@ -66,12 +67,12 @@ quasarr/search/sources/sl.py,sha256=5e5S7JvdbNOc2EthyOkfC4aTpG8O7fn4WS2O3_EXjnM,
 quasarr/search/sources/wd.py,sha256=O02j3irSlVw2qES82g_qHuavAk-njjSRH1dHSCnOUas,7540
 quasarr/search/sources/wx.py,sha256=_h1M6GhkJzixwHscrt0lMOnPSEDP1Xl24OypEe8Jy7c,12906
 quasarr/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-quasarr/storage/config.py,sha256=hOI7vvIo1YaML3dtAkTmp0HSedWF6brVhRk3d8pJtXI,6300
-quasarr/storage/setup.py,sha256=V_dWfyCYxRE_ahmBtD-DmHOKP2L6brBcVYydPRcHjns,21448
+quasarr/storage/config.py,sha256=SSTgIce2FVYoVTK_6OCU3msknhxuLA3EC4Kcrrf_dxQ,6378
+quasarr/storage/setup.py,sha256=YpF11NchXSMRfI7S0yzg-LqlmUhlWMgjZCFyGYDwS5M,38151
 quasarr/storage/sqlite_database.py,sha256=yMqFQfKf0k7YS-6Z3_7pj4z1GwWSXJ8uvF4IydXsuTE,3554
-quasarr-1.26.7.dist-info/licenses/LICENSE,sha256=QQFCAfDgt7lSA8oSWDHIZ9aTjFbZaBJdjnGOHkuhK7k,1060
-quasarr-1.26.7.dist-info/METADATA,sha256=w9WT0BHcf5ogLrgWmm_vmNHMDGtqTk9R5VbIxKCOhCA,12805
-quasarr-1.26.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-quasarr-1.26.7.dist-info/entry_points.txt,sha256=gXi8mUKsIqKVvn-bOc8E5f04sK_KoMCC-ty6b2Hf-jc,40
-quasarr-1.26.7.dist-info/top_level.txt,sha256=dipJdaRda5ruTZkoGfZU60bY4l9dtPlmOWwxK_oGSF0,8
-quasarr-1.26.7.dist-info/RECORD,,
+quasarr-1.27.0.dist-info/licenses/LICENSE,sha256=QQFCAfDgt7lSA8oSWDHIZ9aTjFbZaBJdjnGOHkuhK7k,1060
+quasarr-1.27.0.dist-info/METADATA,sha256=D3_jpkN9ALKqlaZM-X524wBJyJyND7m9RdDlxB3Cqdg,10679
+quasarr-1.27.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+quasarr-1.27.0.dist-info/entry_points.txt,sha256=gXi8mUKsIqKVvn-bOc8E5f04sK_KoMCC-ty6b2Hf-jc,40
+quasarr-1.27.0.dist-info/top_level.txt,sha256=dipJdaRda5ruTZkoGfZU60bY4l9dtPlmOWwxK_oGSF0,8
+quasarr-1.27.0.dist-info/RECORD,,