About
Duux is a Home Assistant integration for controlling Duux v2 appliances through the vendor's cloud. It supports heaters, fans, air conditioners, air purifiers, dehumidifiers and humidifiers, exposing them as climate, fan, humidifier, select, sensor, switch and binary sensor entities. Depending on the model, controls include target temperature, heating or drying modes, fan speed, swing, timers, night mode, child lock, ionizer, laundry mode and spray volume. Air purifiers also report PM2.5, TVOC, air quality index and remaining HEPA filter life. Devices are found automatically, and entities show as unavailable when a device loses its cloud connection. Repair notices can flag a device that is not connected or not recognised, and a diagnostics file can be downloaded for bug reports. Setup is done in the UI with a Duux account email and password.
Automatic summary of the README and code of SSmale/Duux-Home-Assistant. 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.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Climate
- Humidifiers
- Fans
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Duux Login
- Email address
- Password
Texts from the code of SSmale/Duux-Home-Assistant.
Entities
- Binary sensorsConnected, Problem
- SelectsFan Speed, Horizontal Swing, Spray Volume, Timer, Vertical Swing
- SensorsAir Quality Index, Connection Type, Error Message, HEPA Filter remaining lifespan, PM2.5, Time Remaining, TVOC
- SwitchesChild Lock, Cleaning Mode, Ionizer, Laundry Mode, Night Mode, Sleep Mode
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Device not connected via MQTT, Device not recognised
From the README
A Home Assistant integration for Duux products, allowing you to control your devices directly from Home Assistant.
- 📊 Real-time Status: Current temperature, humidity, and device state
- 🔄 Auto-discovery: Automatically finds all your Duux devices
- 🌐 Offline Detection: All entities are marked unavailable when a device is disconnected from the cloud
Shows in Vulpo
Quick Toggle card, Climate card, Fan card, Select card, Apple Watch, Control Center, Climate Live Activity.Information
- Installs
- 231 sharing analytics
- GitHub stars
- 21
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v2.17.1,
- Category
- Climate
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
duux- Issues
- Report an issue











