DoHome API

Async Python library for controlling smart LED bulbs and strips that use the DoIt protocol (DoHome app). Communicates with devices over the local network via TCP/UDP — no cloud required.

Features

• Device discovery via UDP broadcast
• RGB color and white temperature control
• Brightness adjustment
• Built-in light effects (gradients, strobes, jumps)
• Device info, state reading, and power management
• Wi-Fi credential provisioning

Installation

pip install dohome-api

Requires Python 3.12+.

Quick Start

import asyncio
from dohome.api import APIClient, discover
from dohome.transport import TCPStream, UDPBroadcast

async def main():
    # Discover devices on the local network
    broadcast = UDPBroadcast()
    devices = await discover(broadcast)
    broadcast.close()

    if not devices:
        print("No devices found")
        return

    # Connect to the first device
    client = APIClient(TCPStream(devices[0]["sta_ip"]))

    await client.set_power(True)
    await client.set_color((255, 0, 0), 128)  # Red at 50% brightness
    await asyncio.sleep(2)
    await client.set_power(False)

asyncio.run(main())

More examples (device info, Wi-Fi setup, state inspection) are available in the examples/ directory.

Provisioning

You can use this library to perform the initial device setup without using the DoHome app.

To do this:

1. Clone this repository
2. Install dependencies with make configure command
3. Set the DOHOME_SSID and DOHOME_PASSWORD environment variables
4. Connect to the light bulb's access point
5. Run uv run examples/configure.py

API Reference

Discovery

APIClient

License

MIT © Mikhael Khrustik