homebridge-tasmota-control

Homebridge plugin (https://github.com/homebridge/homebridge) to control Tasmota flashed devices.

Usage no npm install needed!

<script type="module">
  import homebridgeTasmotaControl from 'https://cdn.skypack.dev/homebridge-tasmota-control';
</script>

README

Homebridge Tasmota Control

verified-by-homebridge npm npm GitHub pull requests GitHub issues

Homebridge plugin for Tasmota flashed devices.

Package Requirements

Package Installation Role Required
Homebridge Homebridge Wiki HomeKit Bridge Required
Config UI X Config UI X Wiki Web User Interface Recommended
Tasmota Control npm install -g homebridge-tasmota-control Plug-In Required

Note

  • Right now only switch/outlets devices are supported.
  • Tested with latest Tasmota 10.1.0

Troubleshooting

  • If for some reason the device is not displayed in HomeKit app try this procedure:
    • Go to ./homebridge/persist.
    • Remove AccessoryInfo.xxx file which contain Your device data: {"displayName":"Tasmota"}.
    • Next remove IdentifierCashe.xxx file with same name as AccessoryInfo.xxx.
    • Restart Homebridge and try add it to the Home app again.

Configuration

Install and use Homebridge Config UI X plugin to configure this plugin (Highly Recommended). The sample configuration can be edited and used manually as an alternative. See the sample-config.json file in this repository for an example or copy the example below into your config.json file, making the apporpriate changes before saving it. Be sure to always make a backup copy of your config.json file before making any changes to it.

Key Description
name Here set the accessory Name to be displayed in Homebridge/HomeKit.
host Here set the Hsostname or Address IP of the Device.
auth If enabled, authorizatins credentials will be used for login.
user Here set the authorization Username.
passwd Here set the authorization Password.
channelsCount Here select the channels count.
enableDebugMode This enable deep log in homebridge console.
disableLogInfo This disable log info, all values and state will not be displayed in Homebridge log console. 
{
      "platform": "tasmotaControl",
      "devices": [
        {
        "name": "Outlet",
        "host": "192.168.0.4",
        "auth": false,
        "user": "user",
        "passwd": "password",
        "channelsCount": 1,
        "refreshInterval": 5,
        "disableLogInfo": false,
        "enableDebugMode": false,
      }
    ]
  }

Adding to HomeKit

Each accessory needs to be manually paired.

  1. Open the Home app on your device.
  2. Tap the .
  3. Tap Add Accessory, and select I Don't Have a Code or Cannot Scan or More Options.
  4. Select Your accessory.
  5. Enter the Homebridge PIN or scan the QR code, this can be found in Homebridge UI or Homebridge logs.
  6. Complete the accessory setup.

What's New.

Development

  • Pull request and help in development highly appreciated.