2025.4.1
Home ▸ Integrations ▸

Leviton Decora

Support for the Decora Bluetooth dimmer switch Leviton.

The API key can be obtained by downloading this git repository and running the read_key.py script with the Bluetooth address of the switch as the first argument. Hold the switch in the off position until the green status LED starts flashing before running the script. The output is the API key.

To enable these lights, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
light:
  - platform: decora
    devices:
      00:21:4D:00:00:01:
        api_key: YOUR_API_KEY
YAML

Configuration Variables

Looking for your configuration file?
devices map Required

A list of lights to use.

mac_address list Required

The Bluetooth address of the switch.

name string (Optional)

The name to use in the frontend.

Default:

mac_address of this switch

api_key string Required

The API key to access the device.

Note

If you get an error looking like this:

Jun 20 19:41:18 androlapin hass[29588]: ERROR:homeassistant.components.light:Error while setting up platform decora
[...]
Jun 20 19:41:18 androlapin hass[29588]:   File "/usr/lib/python3.6/concurrent/futures/thread.py", line 55, in run
Jun 20 19:41:18 androlapin hass[29588]:     result = self.fn(*self.args, **self.kwargs)
Jun 20 19:41:18 androlapin hass[29588]:   File "/opt/homeassistant/custom_components/light/decora.py", line 68, in setup_platform
Jun 20 19:41:18 androlapin hass[29588]:     light = DecoraLight(device)
[...]
Jun 20 19:41:18 androlapin hass[29588]: OSError: [Errno 8] Exec format error
Txt
  1. Go to your .homeassistant folder
  2. Then go to deps/bluepy subfolder.
  3. Then run make all
  4. Restart Home Assistant