Tasmota
Tasmota
homebridge-tasmota · v0.2.3
VerifiedLocalHomebridge 2.0
Adds Tasmota switches, dimmers, lights and sensors to HomeKit through MQTT auto discovery.
What it says it supports
Brands
- Tasmota
Devices it names
- WiOn outlet module
- Tuya dimmer
- BME280 sensor
- Arilux LC06
- WS2812 LED strip
- DHT22
- BH1750
- AZ-7798 CO2 monitor
- PIR motion sensor
- Wipro Next 20W LED batten
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Auto-discovers Tasmota (and some ESPHome/OpenMQTTGateway) devices over MQTT. DEVICES.md has the maintainer's sample configs for many switches, dimmers and sensors.
- Works16
- Partly works1
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| AM2302/DHT22 temperature sensor on ESP01S | Works | Fahrenheit double-conversion bug fixed after reportSaved copytemperature sensors (AM2302/DHT22 on ESP01S) running tasmota 9.5 set to Fahrenheit are being interpreted as celsius and subsequently re-converted to Fahrenheit. configure device to report Fahrenheit with SO8 1 tasmota web service reports 73º Fahrenheit. homebridge accessory pane reports 164º Fahrenheit, and homekit receives the final value from homebridge Logs: 2021-08-27T23:14:22.999Z Tasmota:mqtt emit tele/sensors/mbathsensor/SENSOR {"Time":"2021-08-28T00:14:23","AM2301":{"Temperature":77.5,"Humidity":49.3,"DewPoint":57.0},"TempUnit":"F"} 2021-08-27T23:14:22.999Z Tasmota:sensor statusUpdate … Excerpt saved from GitHub on 2026-10-22. | Issue #33 · 2021-08 |
| AZ-7798 CO2 monitor | Works | CO2 support added and tested with this monitorSaved copyI have implemented support for the AZ-7798 CO2 Monitor. In the log below you can see it does not send a `device_class`, so I used the `ic` value. I don't know if this is the right solution, but it does work. [code] Excerpt saved from GitHub on 2026-10-22. | PR #13 · 2020-09 |
| CE SMART WiFi Dimmer | Works | Sample Tasmota configSaved copy… discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + BME280 Temperature Sensor PIR Motion + BME280 Temperature Sensor + BH1750 Lux Illuminance Sensor ZMAi-90 Current Sensor Switch MCULED Device with RGB+W Strip MCULED Device with RGB+W Strip - Version 2 ( … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| FEIT WiFi Dimmer | Works | Sample config; can also slave as remote light switch to iFanSaved copy… override of discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + BME280 Temperature Sensor PIR Motion + BME280 Temperature Sensor + BH1750 Lux Illuminance Sensor ZMAi-90 Current Sensor Switch MCULED Device with RGB+W Strip MCULED Device with RGB+W Strip - … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Gowfeel EN71 water valve | Works | Needed case opened to flash Tasmota; sample configSaved copy… version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + BME280 Temperature Sensor PIR Motion + BME280 Temperature Sensor + BH1750 Lux Illuminance Sensor ZMAi-90 Current Sensor Switch MCULED Device with RGB+W Strip MCULED Device with RGB+W Strip - Version 2 ( Basement ) MCULED Device with RGB+W Strip - Version 2 ( Cottage Sink ) Tuya Dimmer Module as a FAN Trailer Relay Board Gowfeel … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Greeni GNC-SW003-199 | Works | Sample Tasmota configSaved copy… after 30 minutes Hampton Bay Fan/Light RF Remote Control ( 303.9 Mhz ) Valor Fireplace Remote ( 315 Mhz ) Treatlife DS03 Fan Controller and Light Dimmer Greeni GNC-SW003-199 OpenMQTTGateway devices Hampton Bay Light Hampton Bay FAN openMQTTGateway / PiLight temperature sensor Internet Connection WatchDog Version 1 ( Uses node-red to monitor google.com and turn off the plug ) Version 2 Version 3 - Do three checks before rebooting My standard config after setting name and device configuration Tasmota Configuration [code] Sonoff IFAN03 Tasmota Configuration [code] configuration override of … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Hampton Bay fan/light RF remote | Works | Via 303.9 MHz RF bridge sampleSaved copy… ) Sample Device Configurations ( My personal collection ) My standard config after setting name and device configuration Tasmota Configuration Sonoff IFAN03 Tasmota Configuration configuration override of discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| MCUIOT BME280 / DHT11 sensors | Works | Temperature sensor sample configsSaved copy… 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + BME280 Temperature Sensor PIR Motion + BME280 Temperature Sensor + BH1750 Lux Illuminance Sensor ZMAi-90 Current Sensor Switch MCULED Device with RGB+W Strip MCULED Device with RGB+W Strip - Version 2 ( Basement ) MCULED Device with RGB+W Strip - Version 2 … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| MCULED RGB+W strip | Works | Sample configs, two versionsSaved copy… configuration - BME280 Motion + BME280 Temperature Sensor PIR Motion + BME280 Temperature Sensor + BH1750 Lux Illuminance Sensor ZMAi-90 Current Sensor Switch MCULED Device with RGB+W Strip MCULED Device with RGB+W Strip - Version 2 ( Basement ) MCULED Device with RGB+W Strip - Version 2 ( Cottage Sink ) Tuya Dimmer Module as a FAN Trailer Relay Board Gowfeel EN71 Water Valve Homebrew Doorbutton Button Homebrew Garage Door Opener CE SMART Wifi Dimmer FEIT Wifi Dimmer Using a FEIT Wifi Dimmer as a remote switch to OpenBK RGBCCT Potlights Turn off after 30 minutes Hampton Bay Fan/Light RF … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Sonoff iFan03 | Works | Fan plus light via discovery overrideSaved copy… collection ) Sample Device Configurations ( My personal collection ) My standard config after setting name and device configuration Tasmota Configuration Sonoff IFAN03 Tasmota Configuration configuration override of discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Sonoff iFan03/iFan04 flashed with Tasmota | Works | Recommended for controlling ceiling fan and lightSaved copySonoff ifan03 or ifan04, flashed with tasmota Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-02 |
| Sonoff T1 | Works | Flash Tasmota then integrate; works a treatSaved copySonoff T1 - Easy flash with Tasmota and then integrate with Homebridge. Works a treat. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2019-09 |
| Tasmota ESP8266 BME280 sensor | Works | WiFi temperature sensors via tasmota pluginSaved copy… https://www.amazon.ca/gp/product/B01BICMM1I/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1 And have a rtl-sdr plugged into my raspberry pi running the homebridge-rtl plugin. I also have some DIY esp8266’s with a bme280 temperature sensor connected, running the tasmota firmware. These use WiFi and the homebridge-tasmota plugin. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-04 |
| Treatlife DS03 fan controller and dimmer | Works | Sample Tasmota configSaved copySample Device Configurations ( My personal collection ) Sample Device Configurations ( My personal collection ) My standard config after setting name and device configuration Tasmota Configuration Sonoff IFAN03 Tasmota Configuration configuration override of discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| Tuya dimmer module as fan | Works | Sample config exposing dimmer as a fanSaved copy… ) Sample Device Configurations ( My personal collection ) My standard config after setting name and device configuration Tasmota Configuration Sonoff IFAN03 Tasmota Configuration configuration override of discovery object to create a FAN ( post version 0.1.0 ) configuration override of discovery object to create a FAN ( pre version 0.1.0 ) Slave a FEIT Wifi Dimmer Wall Switch to an iFan as a light switch BME280 Temperature Sensor - MCUIOT DHT11 Temperature Sensor - MCUIOT Water Leak Sensor with On/Off control LEAK Tasmota configuration - DHT11 Leak Tasmota configuration - BME280 Motion + … Excerpt saved from GitHub on 2026-10-22. | Docs: DEVICES.md |
| ZMAi-90 current sensor switch | Works | Power sensor support added with fakegato historySaved copyFix for OpenMQTTGateway devices crashing plugin Fix for color flip flops Support for Pressure sensor on BME280 and other others ( Only visible from HomeKit apps that support pressure ) Support for ZMAi-90 Current Sensor / Switch Support for Fakegato history for Temperature, Humidity, Current and Pressure sensors. Added support for overriding the discovery response Added tasmota device type fan, to allow control of Fan ( Based on a dimmable device ) Added tasmota binary sensor device moisture as a water leak device Excerpt saved from GitHub on 2026-10-22. | PR #20 · 2020-10 |
| Tuya bulb flashed with Tasmota | Partly works | Colour never worked correctly in HomeKitSaved copy+1 for the procedure. I flashed with Tasmota and could never get the color working correctly in HomeKit. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-05 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
MQTT with Home Assistant discovery
You’ll need
- MQTT broker
- Tasmota below version 12
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.6.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | >=18 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | Tasmota |
| License | Apache-2.0 |
Community signals
| Downloads a week | 14 |
|---|---|
| Downloads a month | 290 |
| GitHub stars | 36 |
| Open issues | 1 |
| Closed issues | 39 |
| Last code push | 2026-08-15 |
| Latest version | 0.2.3 (2025-12-03) |
| First published | 2020-08-26 |
| Releases | 159 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- HA discovery removed in Tasmota 12
- Devices must report device_class
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirQualitySensor
- CarbonDioxideSensor
- ContactSensor
- Fan
- GarageDoorOpener
- HumiditySensor
- InputSource
- LeakSensor
- LightSensor
- Lightbulb
- MotionSensor
- Outlet
- Television
- TemperatureSensor
Sources
- npm: https://www.npmjs.com/package/homebridge-tasmota
- Source code: https://github.com/NorthernMan54/homebridge-tasmota
- Issues: https://github.com/NorthernMan54/homebridge-tasmota/issues
- Verified plugins list: https://github.com/homebridge/verified
