aiopyarr
An Asynchronous Lidarr, Radarr, Readarr, Sonarr APIs for Python.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later and an active instance of Lidarr, Radarr, Readarr, or Sonarr with API access enabled.
- 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 · maintenance · safety
MIT license (permissive) — MIT license (permissive) places no restrictions on use, modification, or redistribution in proprietary or open-source projects.
last release 2023-04-09 (1223 days) · last repo commit 2024-09-07 · 18 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 73,847 downloads/mo, #14,922 on PyPI
Alternatives
Verify before relying
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()- 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.
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 on it.
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
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.
Requires Python 3.9 or later and an active instance of Lidarr, Radarr, Readarr, or Sonarr with API access enabled.
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()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
| License | MIT license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageaiohttp |
| Maintenance | Dormant 1,223 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 73,847 / month, #14,922 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries :: Python Modules |
Evidence: aiopyarr-23.4.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “lidarr radarr sonarr python client”
- aiopyarrAsync Python client library for Lidarr, Radarr, Readarr, and Sonarr…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
- openapi-python-clientGenerates type-annotated Python HTTP clients from OpenAPI 3.0 and 3.1…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also aioymaps · pyipp · plexwebsocket · PlexAPI · aioairq · elgato · directv · aiortsp · pyjvcprojector · glean-api-client