Yeelight Pro for Home Assistant (Marketplace integration)

Installs: 57 sharing analytics
GitHub stars: 3
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.0.5, July 1, 2026
Category: Lighting, Bulbs and lamps
Kind: Marketplace integration
Brand: Yeelight
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: yeelight_pro
Source: github.com/Yeelight/ha_yeelight_pro
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Yeelight Pro is an integration that connects Yeelight Pro homes, devices, gateways and scenes to Home Assistant. It supports Yeelight cloud, private deployment and local gateway connection modes, and it is set up in the UI. It adds lights, climate, covers, fans, sensors, switches, buttons, numbers, selects, events and binary sensors, plus selectors for the active room, group and scene. Options cover the polling interval, WebSocket event notifications, filtering of unknown capabilities, and choosing which rooms, gateways and devices to import. Admin actions assign areas, refresh data, and run a registry cleanup that starts as a dry run, and devices can start automations directly. Repairs notices appear when the device list changes, and a diagnostics file can be downloaded.

Automatic summary of the README and code of Yeelight/ha_yeelight_pro. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Lights
Climate
Fans
Covers
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Select Connection Mode

Connection Mode

Access Token authentication

Access Token

Select authentication method

Authentication method

Select House

House

Select devices

Devices

Private Deployment URL

Service root URL
WebSocket push URL

Select cloud region

Region

Reauthentication

New Access Token

After setup

Polling interval (seconds)
Enable debug services
Hide unknown capability entities
Create Repairs on topology changes
Enable WebSocket event notifications
Private deployment WebSocket push URL
Enable local gateway control
Local gateway address
Local gateway port
Device Categories
Rooms
Gateways
Devices
Devices

Texts from the code of Yeelight/ha_yeelight_pro.

Entities

SelectsActive room, Active group, Active scene

Actions

Assign AreasAssign areas to HA devices or devices linked to entities (admin service)
Auto Assign AreasAssign areas based on room keywords in device names (admin service)
Emit Debug EventEmit a debug Yeelight Pro device event to the Home Assistant event bus (admin service)
Dump Push HealthWrite aggregate Yeelight Pro WebSocket push diagnostics to the Home Assistant log (admin service)
Emit Debug Push PayloadInject one synthetic Yeelight Pro property push to verify the live refresh path; this does not control a real device (admin service)Fields: Node type, Push payload shape, Property parameters, Source device ID, Entity ID
Manual RefreshRefresh loaded Yeelight Pro data and synchronize device and entity registries (admin service)Fields: Refresh product schemas
Registry cleanup dry-runDry-run stale Yeelight Pro entities; after confirmation, disable stale entities through the Home Assistant registry (admin service)Fields: Config entry ID, Confirm cleanup, Audit ID

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Yeelight Pro device list changed

From the README

Yeelight Pro is a Home Assistant custom integration for Yeelight Pro homes, devices, gateways, scenes, and runtime diagnostics. It supports Yeelight cloud, private deployment, and LAN gateway connection modes through one config flow.
Cloud, private deployment, and LAN gateway setup in one config flow
Yeelight APP scan-login setup through regional account APIs; QR-code login is the primary cloud login UX
Advanced manual access-token setup for existing Yeelight Pro deployments
Reauthentication flow for expired or invalid tokens
Configurable polling interval, debug mode, unknown capability filtering, manual non-destructive device import filtering, live updates, LAN gateway control, and topology Repairs notifications
Product schema loading from both v1 and v2 schema endpoints, merged conservatively for maximum capability coverage
Persistent Home Assistant.storage product schema cache for stable schema-aware projections across restarts
Canonical -> adapter -> converter -> projector -> entity architecture
Lightweight Yeelight IoT registry for category, component, property, event, protocol, and nodeType facts
Device registry topology for gateways, child devices, scenes, groups, rooms, areas, and house-level helper entities
House-level analytics diagnostic sensors for alarm, energy, user-action, and endpoint-health aggregates; optional analytics endpoint failures degrade to unavailable diagnostic values instead of…

From the README of Yeelight/ha_yeelight_pro, MIT License. Shortened.