aiopyarr

What it is and what it does

aiopyarr is an async Python wrapper around the REST APIs of four popular media server applications: Lidarr (music), Radarr (movies), Readarr (books), and Sonarr (TV). It lets you query and control these services programmatically—checking system status, managing libraries, and automating media workflows—using Python's async/await syntax. The library depends only on aiohttp for HTTP requests, keeping the installation lightweight.

The package is dormant: its last release was in April 2023, though the repository shows a commit in September 2024. It supports Python 3.9 and later and is permissively licensed under MIT. It has modest adoption among users automating these media servers.

Use it for:

• Automate media library management across Lidarr, Radarr, Readarr, or Sonarr instances from a Python script or bot.
• Build a dashboard or monitoring tool that queries system status and library statistics from multiple instances.
• Integrate media server control into a larger home automation or media orchestration workflow.
• Programmatically add, update, or remove media entries in libraries based on external triggers or data sources.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Async Python client library for Lidarr, Radarr, Readarr, and Sonarr media server APIs, enabling programmatic control and querying of these services.

Yes, with caution. The package is stable and permissively licensed, with low install friction and no known vulnerabilities. However, dormancy since April 2023 means it may lag behind API changes in newer versions of the applications. Install it if you need async control of these services and your instances are on stable versions; verify API compatibility with your specific application versions before relying on it in production.

Install

aiopyarr on PyPI

pip install aiopyarr

uv add aiopyarr

poetry add aiopyarr

Installing aiopyarr

Before you install

Low install friction with a single runtime dependency (aiohttp). Maintenance is dormant—last release was in April 2023 and the last commit was September 2024, indicating the package is not actively developed but remains available.

License in practice

MIT license (permissive) places no restrictions on use, modification, or redistribution in proprietary or open-source projects.

Quickstart

pip install aiopyarr

import asyncio
from aiopyarr.models.host_configuration import PyArrHostConfiguration
from aiopyarr.radarr_client import RadarrClient

host_config = PyArrHostConfiguration(ipaddress="192.168.1.1", api_token="token")
async with RadarrClient(host_configuration=host_config) as client:
    status = await client.async_get_system_status()

Requires Python 3.9 or later and an active instance of Lidarr, Radarr, Readarr, or Sonarr with API access enabled.

Verify before relying

• Whether the package remains compatible with current versions of Lidarr, Radarr, Readarr, and Sonarr APIs.
• Extent of API coverage across all four supported applications.
• Whether dormancy indicates maintenance issues or simply stable, feature-complete status.

Package facts

Evidence: aiopyarr-23.4.0-py3-none-any.whl

Keywords: aiopyarr, radarr, sonarr, plex

Tags

More Python Modules packages