Skip to main content

Magazarr

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 to library.

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.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for magazarr 0.5.3
File Size Uploaded Provenance
magazarr-0.5.3.tar.gz 144.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for magazarr 0.5.3
File Interpreter ABI Platform
magazarr-0.5.3-py3-none-any.whl Python 3 none any Details

Total release size: 261.5 kB

Release files / magazarr-0.5.3.tar.gz

Download URL magazarr-0.5.3.tar.gz
Size 144.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ef0f81f1bce27bc2bc673ed0dc506d4f4c9435e9e4a65a70b52dbd44c2435efe
BLAKE2b-256 checksum
How to use checksums
e6135adea6cfd4dd3dc842e389d619c1d0ace4e54547fe2eeb1eafa7d8ef4115
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.5.3-py3-none-any.whl

Download URL magazarr-0.5.3-py3-none-any.whl
Size 117.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a568e12ffa95dd496e45ff4b1d99e554eaee7f73b5a9b8b78e3d4a5c15031951
BLAKE2b-256 checksum
How to use checksums
0ba45df99fe044ed02009587a644ec40020f2a97772b6004b8a45a54a4daba48
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.5.3

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.

Release history Release notifications | RSS feed

This release

0.5.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page