duux👋 Introduction
A library for controlling Duux Whisper Flex 2 smart fans through the Cloudgarden cloud API and a local MQTT broker.
@kud/duux controls Duux Whisper Flex 2 smart fans — passwordless sign-in, device discovery, one-shot commands, and a stateful session that reacts to state changes over either Duux's Cloudgarden cloud API or a local MQTT broker. It's the core library behind @kud/duux-cli, the terminal client.
What's here
- 🚀 Getting Started — install, sign in, and discover your fans
- 🔍 Discovery & Devices — listing fans, addressing them correctly, and renaming them
- 🎛️ Commands — the
tune set <param> <value>grammar and every builder - 🔁 Sessions — a live, event-driven connection to a fan
- 🔌 Transports — cloud vs local MQTT, and the protocol quirks of each
- 📚 API Reference — the full export surface