Twinkly

The Twinkly integration allows you to control Twinkly LED string from Home Assistant.

This integration can be used to:

  • Turn your Twinklys on and off
  • Adjust brightness
  • Control static colors and effects
  • Switch between operation modes (see explanation below)

Music mode is currently not supported.

Effects

For devices with software version > 2.7.1, you can also control the effects on your Twinklys.

The Twinkly devices do not initially have any effects stored locally. Effects must be added from the Twinkly application before they become visible in Home Assistant.

Make sure the latest firmware is installed on your Twinkly devices and add effects by apply-ing them from the Twinkly app.

Operation Modes

Modes can be switched using the select entity.

For most use cases, “Color”, “Movie” and “Playlist” modes are the most relevant.

Color Mode

  • Displays a static color
  • Controlled through the light entity
  • Color can be set via RGB/RGBW

Movie Mode

  • Plays effects previously uploaded through the Twinkly app
  • Effects must be created and transferred to the device first using the app
  • Effect selection is done through the light entity

Playlist Mode

  • Sequential playback of multiple effects
  • Playlist must be uploaded through the Twinkly app first

Off Mode

  • Turns off the lighting

Demo Mode

  • Shows predefined demo effects
  • Primarily intended for presentation purposes
  • Limited practical use

Unsupported Modes:

  • Effect Mode: predefined effects built into the device. Alternatively, you can use Movie Mode
  • RT (Real-Time): Live control of individual LEDs
  • Music: Music-controlled light show

Configuration

To add the Twinkly integration to your Home Assistant instance, use this My button:

Twinkly can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

If configured using an IP address, on your router / DHCP, you should assign a static IP to your Twinkly device.