Magazarr is a small magazine-only companion for Quasarr.
It keeps a free-text magazine list, searches Quasarr for recent issues, sends chosen releases back to Quasarr for download, imports the largest PDF from completed JDownloader folders, and exposes the library through OPDS.
Magazarr automatically searches active titles every 60 minutes by default and checks completed downloads for import every minute by default. Set either interval to 0 to disable that background task.
Run
uv run magazarr
Open http://127.0.0.1:8090.
Docker
Local build:
uv build
mkdir -p docker/dist
cp dist/*.whl docker/dist/
docker build -t magazarr:local docker
Local run:
docker run --rm \
-p 8090:8090 \
-v "$PWD/config:/config" \
-v "$PWD/library:/library" \
-v "$PWD/output:/output" \
magazarr:local
Compose template lives at docker/docker-compose.yml. Replace ghcr.io/your-github-user/magazarr:latest with your published image.
Required Settings
- Quasarr URL and API key.
- Completed package folders reported by Quasarr must be visible to Magazarr at the exact path returned in Quasarr history.
- Library directory for imported PDFs. Docker defaults to
/library; local runs default tolibrary.
Run Quasarr Locally For Testing
In a second terminal:
cd ~/PythonProjects/Quasarr
INTERNAL_ADDRESS=http://127.0.0.1:8080 uv run quasarr
Use the API key printed by Quasarr in Magazarr settings:
- Quasarr URL:
http://127.0.0.1:8080 - Search category:
7000 - Download category:
docs
Quasarr still needs working JDownloader credentials and at least one configured magazine-capable hostname before a real download can complete.
Quasarr Integration
Magazarr uses the Quasarr Newznab/SABnzbd shim:
- Search:
GET /api?t=search&q=<title>&cat=7000&apikey=<key> - Download:
GET /api?mode=addurl&name=<quasarr download link>&cat=docs&apikey=<key> - Import status:
GET /api?mode=history&apikey=<key>
OPDS
OPDS root is:
http://127.0.0.1:8090/opds
Optional basic auth applies only to OPDS routes.
Imported PDF issue entries expose a cover image link. Magazarr renders page 1 of the PDF as a cached PNG on first cover request.
License
MIT License. Copyright (c) 2026 RiX.
Metadata
Release files for magazarr 0.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| magazarr-0.7.2.tar.gz | 144.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| magazarr-0.7.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 261.4 kB
Release files / magazarr-0.7.2.tar.gz
| Download URL | magazarr-0.7.2.tar.gz |
|---|---|
| Size | 144.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e6db4a98e93f9182e52a3bb2865a29cfa2250dc9c35f4fb9b181058b86c1e89
|
|
BLAKE2b-256 checksum How to use checksums |
33df1b5d6fd13fb7fc4f3c8ef119c941305f642bf310b9d1c4e80b252d671b82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / magazarr-0.7.2-py3-none-any.whl
| Download URL | magazarr-0.7.2-py3-none-any.whl |
|---|---|
| Size | 117.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
334725ac9bf3d79cab6b635edf23487eb789af0ac19532f37ea7dff4c4a239b9
|
|
BLAKE2b-256 checksum How to use checksums |
df617664b6ee200ca2fa4c2bf818cdef397ad6f89c9778331ab8408524a7c1d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for magazarr 0.7.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.