wiim
A Python-based API interface for controlling and communicating with WiiM audio devices.
Decision gist · record as of 2026-08-14
Yes, if you own WiiM devices and need programmatic control from Python. The library is actively maintained, has no known vulnerabilities, uses permissive MIT licensing, and depends only on stable async libraries. Install friction is low. The project is young (first release 2025-07-02) but shows active development. Start with the quick-start example to verify device discovery works on your network.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a WiiM device on your local network; device discovery via zeroconf works best on networks with mDNS support enabled.
- Low friction install as a pure-Python wheel.
- Active maintenance with a recent commit on 2026-08-04 and first release in 2025-07-02, so the project is young but actively developed.
License · maintenance · safety
MIT (permissive) — MIT license is permissive, allowing use in commercial and private projects with minimal restrictions. You must retain the license notice but face no copyleft obligations.
last release 2026-08-03 (11 days) · last repo commit 2026-08-04 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 75,225 downloads/mo, #14,737 on PyPI
Alternatives
Verify before relying
pip install wiim
import asyncio
from wiim import WiimDevice
async def main():
device = WiimDevice("device_ip_address")
await device.async_update()
print(device.playback_status)
asyncio.run(main())- Whether the package works with Python versions older than 3.x or has specific version constraints beyond 'Python :: 3'
- Whether WiiM device discovery works reliably across different network topologies or requires specific mDNS/UPnP configuration
- Minimum Python version required for async code support
What it is and what it does
wiim is a Python library for controlling WiiM smart audio devices—speakers and receivers built on LinkPlay modules—over your local network. It abstracts the device discovery and control protocol, letting you write Python code to play, pause, skip, adjust volume, manage playback metadata, and coordinate multiroom audio groups without directly handling UPnP or mDNS details.
The library uses aiohttp for HTTP communication, async-upnp-client to interact with UPnP device descriptions, and zeroconf to discover WiiM devices by their _linkplay._tcp.local. service advertisement. It's designed for smart home automation, custom music player applications, or any Python tool that needs to remote-control WiiM hardware. The API is async-first, reflecting its dependency on aiohttp and the async networking stack.
Use it for
- Build a custom Python home automation script that discovers WiiM speakers on startup and plays music on demand.
- Create a multiroom audio synchronization tool that groups WiiM devices and coordinates playback across rooms.
- Integrate WiiM device control into a larger smart home platform or voice assistant backend.
- Monitor playback metadata in real-time to display currently playing track information on a dashboard or display.
- Implement a Python-based music player UI that sends commands to WiiM hardware instead of local playback.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own WiiM devices and need programmatic control from Python.
The library is actively maintained, has no known vulnerabilities, uses permissive MIT licensing, and depends only on stable async libraries. Install friction is low. The project is young (first release 2025-07-02) but shows active development. Start with the quick-start example to verify device discovery works on your network.
Install
wiim on PyPI
Before you install
Low friction install as a pure-Python wheel. Active maintenance with a recent commit on 2026-08-04 and first release in 2025-07-02, so the project is young but actively developed. Depends on aiohttp, async-upnp-client, and zeroconf—all stable async networking libraries.
Requires a WiiM device on your local network; device discovery via zeroconf works best on networks with mDNS support enabled.
License in practice
MIT license is permissive, allowing use in commercial and private projects with minimal restrictions. You must retain the license notice but face no copyleft obligations.
Quickstart
pip install wiim
import asyncio
from wiim import WiimDevice
async def main():
device = WiimDevice("device_ip_address")
await device.async_update()
print(device.playback_status)
asyncio.run(main())Verify before relying
- Whether the package works with Python versions older than 3.x or has specific version constraints beyond 'Python :: 3'
- Whether WiiM device discovery works reliably across different network topologies or requires specific mDNS/UPnP configuration
- Minimum Python version required for async code support
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesaiohttpasync-upnp-clientzeroconf |
| Maintenance | Actively maintained 11 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 75,225 / month, #14,737 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: wiim-0.1.6-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 › “wiim device control python”
- wiimwiim provides a Python API to discover, control, and monitor WiiM…
- brainstemProvides Python bindings to control and interact with Acroname…
- pytangoPyTango exposes the complete Tango C++ API through Python, providing…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also plugwise · sonos-websocket · soco · nmcli · python-songpal · pycaw · libsoundtouch · python-miio · broadlink · axis