wled

What it is and what it does

wled is an asynchronous Python client for controlling WLED devices—programmable LED strips that expose a network API. It wraps HTTP communication with aiohttp and handles serialization via mastering and orjson, allowing you to query device state, adjust brightness and color, toggle effects, and manage segments from Python code. The library is designed for integration into home automation systems and third-party applications that need to automate LED behavior without blocking the event loop.

The package targets modern Python (3.11–3.14) and is actively maintained with a permissive MIT license. It depends on standard async ecosystem libraries (aiohttp, yarl, awesomeversion, python-backoff, mashumaro) and installs as a pure wheel with no compiled dependencies, making it straightforward to add to existing projects.

Use it for:

• Integrate WLED strips into a Home Assistant automation or custom home automation system.
• Build a Python script to synchronize LED colors with music, time of day, or external events.
• Monitor and control multiple WLED devices programmatically from a central application.
• Automate LED brightness and effects based on sensor input or scheduled tasks.
• Develop a web dashboard or CLI tool that communicates with WLED devices over the network.

Worth the install?

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

An asynchronous Python client library for controlling and monitoring WLED devices over the network, enabling programmatic automation of LED strip behavior.

Yes. The package is actively maintained, carries no known vulnerabilities, installs with low friction, and provides a clean async API for a well-defined task. Install it if you need to control WLED devices from Python; skip it if you have no WLED hardware or prefer synchronous code.

Install

wled on PyPI

pip install wled

uv add wled

poetry add wled

Installing wled

Before you install

Low friction install with a pure-Python wheel distribution. The package is actively maintained with recent releases and carries no known vulnerabilities. Dependencies are all stable, widely-used async and serialization libraries.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both personal and commercial projects.

Quickstart

pip install wled

import asyncio
from wled import WLED

async def main():
    async with WLED("wled-frenck.local") as led:
        device = await led.update()
        await led.master(on=True, brightness=255)

asyncio.run(main())

Requires Python 3.11 or later; the WLED device must be reachable on the network.

Verify before relying

• Whether the package supports all WLED firmware versions or only recent ones.
• Whether network discovery or device auto-detection is available beyond direct hostname/IP.
• Specific rate limits or throttling behavior when controlling multiple segments or effects.

Package facts

Evidence: wled-0.23.0-py3-none-any.whl

Keywords: api, async, client, home-assistant, led, wled

Tags

More Python Modules packages