async-upnp-client

What it is and what it does

async-upnp-client is an asyncio-based UPnP client library for Python that discovers, describes, controls, and subscribes to events from UPnP devices on a network. It maps to the UPnP Device Architecture standard, providing modules for SSDP discovery, device description parsing, service control, and event handling. The library includes profiles for Internet Gateway Devices (IGD), DLNA media renderers, and printers, making it suitable for home automation and network device integration.

The package is built on aiohttp for HTTP communication, defusedxml for safe XML parsing, python-didl-lite for DLNA metadata, and voluptuous for validation. It exposes both a programmatic API for integration into larger applications and a command-line tool (upnp-client) for ad-hoc device discovery, action invocation, and event subscription. Originally developed for Home Assistant, it is production-ready and actively maintained.

Use it for:

• Discover and control DLNA media renderers (speakers, TVs) from a Python application.
• Query and manage Internet Gateway Device (IGD) settings like port forwarding and WAN status.
• Build a home automation hub that listens for UPnP device advertisements and state changes.
• Invoke UPnP service actions (e.g., GetVolume, Play) on networked devices programmatically.
• Monitor printer status and capabilities via UPnP service subscriptions.

Worth the install?

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

Async UPnP client library for discovering, controlling, and eventing with UPnP devices over asyncio, supporting DLNA, IGD, and printer profiles.

Yes. The library is actively maintained, production-stable, has no known vulnerabilities, low install friction, and a permissive license. Install it if you need to integrate UPnP device discovery or control into an asyncio application, particularly for DLNA or home automation use cases.

Install

async-upnp-client on PyPI

pip install async-upnp-client

uv add async-upnp-client

poetry add async-upnp-client

Installing async-upnp-client

Before you install

Low install friction with four straightforward dependencies. Active maintenance with a release 19 days ago and recent commits; the project is marked Production/Stable and supports current Python versions (3.10–3.14).

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

import asyncio
from async_upnp_client import UpnpFactory

async def main():
    factory = UpnpFactory()
    devices = await factory.async_search()
    for device in devices:
        print(device)

asyncio.run(main())

Requires Python 3.10 or later; asyncio event loop must be running.

Verify before relying

• Whether the library fully implements all UPnP Device Architecture sections or has known gaps beyond what the description notes.
• Performance characteristics when handling many concurrent device connections or subscriptions.
• Compatibility with specific UPnP device types beyond the three profiles (IGD, DLNA, printer) mentioned.

Package facts

Evidence: async_upnp_client-0.48.0-py3-none-any.whl

Keywords: ssdp, Simple Service Discovery Protocol, upnp, Universal Plug and Play

Tags

More Internet packages