---
id: aiopyarr
version: "23.4.0"
license: MIT license
license_treatment: permissive
maintenance: dormant
---

# aiopyarr — An Asynchronous Lidarr, Radarr, Readarr, Sonarr APIs for Python.

License: permissive · Maintenance: dormant · Downloads: 73.8K/mo

## 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 above — 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

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

- License: MIT license (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 73.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lidarr radarr sonarr python client, async media server api wrapper, arr apps python automation, readarr lidarr api client, sonarr radarr async control, media-server-automation, async-api-client

[View on SkillFed](https://skillfed.io/packages/aiopyarr) · [View on PyPI](https://pypi.org/project/aiopyarr/)