• 8 min read

How to Connect Twinkly Lights to Apple HomeKit

How to connect Twinkly lights to Apple HomeKit with ATH Bridge

If you want to control your Twinkly lights from your iPhone, iPad, or with Siri, connecting them to Apple HomeKit is the easiest way to do it. This guide covers how to connect Twinkly lights in general, which Twinkly models work with HomeKit directly, how to bridge older models using ATH Bridge or Homebridge, and how Twinkly fits in if you already use Home Assistant.

💡
Quick Answer:
Twinkly Generation II lights connect to Apple HomeKit directly through the Twinkly app, with no extra hardware needed. Generation I devices, plus Twinkly PRO and Twinkly Plus, do not support native HomeKit and need a bridge such as ATH Bridge or Homebridge. Once connected, you control your Twinkly lights from the Apple Home app, with Siri, and inside HomeKit automations.

Key Takeaways:

• Generation II Twinkly retail lights (Line, Flex, Squares, Strings, Curtains, Dots, and similar) work with Apple HomeKit natively, once your firmware is updated.

• A few Generation II products are exceptions: Twinkly USB-C Strings, Twinkly Tree Topper, and Twinkly Matrix do not support native HomeKit.

• Twinkly PRO, Twinkly Plus, and Lightwall controllers are not supported by native HomeKit.

• If you have an older Generation I device, or a PRO/Plus controller, you need a bridge like ATH Bridge or Homebridge to reach HomeKit.

• Twinkly also has its own official Home Assistant integration, which is separate from HomeKit and does not require ATH Bridge.

How Do You Connect Twinkly Lights in General?

Before HomeKit comes into it, every Twinkly light connects the same basic way. You plug in the lights, download the free Twinkly app for iOS or Android, create a Twinkly account, and let the app find your device over Wi-Fi or Bluetooth. Once your Twinkly light shows up in the app, you can control colors, effects, and schedules from there.

This general setup is the same whether you plan to use Twinkly on its own, with Apple HomeKit, with Amazon Alexa or Google Home, or with Home Assistant. HomeKit support is an extra step on top of this basic setup, and it depends on which Twinkly device you own.

Why Use ATH Bridge for Twinkly HomeKit?

Twinkly lights are great for adding color and motion to a room, but not every Twinkly device talks to Apple HomeKit on its own. For the models that do not support HomeKit directly, ATH Bridge works as a go-between. It is a pre-flashed Homebridge server, so it connects non-HomeKit devices like older Twinkly lights to the Apple Home app without you having to build a Homebridge setup from scratch.

Learn more about how ATH Bridge connects any smart device to HomeKit.

With ATH Bridge, you get:

  • Control from the Apple Home app
  • Siri voice commands
  • HomeKit automations and scenes

For setup instructions, follow the ATH Bridge setup and plugin guide.

If your Twinkly lights already support HomeKit natively (see the table below), you do not need ATH Bridge or any other bridge. You only need one if your Twinkly device falls outside native support.

Which Twinkly Lights Work with Apple HomeKit?

Compatibility comes down to which Twinkly product line and generation you own.

Device Type Generation Native HomeKit Needs a Bridge
Twinkly Line, Flex, Squares (Home range) Gen II Yes No
Twinkly Strings, Curtains, Dots, Icicles (Retail) Gen II Yes No
Twinkly USB-C Strings Gen II No Yes
Twinkly Tree Topper Gen II No Yes
Twinkly Matrix Gen II No Yes
Older Twinkly Retail Lights Gen I No Yes
Twinkly PRO (Wi-Fi and Ethernet) PRO No Yes
Twinkly Plus PRO / Plus No Yes

Twinkly's own support documentation confirms that HomeKit is available on Generation II devices, with the listed exceptions, and that PRO, Plus, and Lightwall controllers are not supported.

How to check your generation: Open the Twinkly app, go to your device settings, and check the firmware version. HomeKit needs firmware 2.8.3 or later, which is only available on Generation II hardware. You can also check the controller shape: Generation II controllers are more rectangular, while Generation I controllers are closer to square.

How Do You Connect Generation II Twinkly Lights to HomeKit?

If your lights are Generation II, connecting to HomeKit is a built-in feature. No extra hardware is needed.

Prerequisites:

1
iOS Device:
You need an iPhone or iPad.
2
Generation 2 Twinkly Lights:
Ensure your lights are Generation 2.
3
Latest Firmware:
Make sure your Twinkly lights are updated to at least firmware version 2.8.3.

Steps to Connect:

1
Open the Twinkly app on your iOS device.
2
Add your Twinkly lights as an accessory in the app.
3
Scan the accessory code that comes with your lights.
4
Select the HomeKit option and enable it.
5
Tap on Add Device to Home and confirm by tapping OK.
6
Choose a location for your lights in the Home app and tap OK.
7
Tap Done.

Your Twinkly lights are now part of your HomeKit setup. You can control brightness, turn them on or off, and build automations from the Home app.

Can You Connect Twinkly Lights to Home Assistant?

Yes. Twinkly has its own official integration built into Home Assistant, separate from Apple HomeKit. It has been part of Home Assistant core since release 2020.12 and can usually auto-discover your Twinkly device on the network. Through this integration, Home Assistant can control on/off, brightness, and effects, once those effects have been added through the Twinkly app.

This matters for two groups of people:

If you already use Home Assistant, you do not need ATH Bridge or HomeBridge just to control Twinkly from Home Assistant. The native integration handles this directly.

If you want your Twinkly lights in Apple HomeKit and already use Home Assistant, Home Assistant's own HomeKit Bridge integration can expose your Twinkly device (and other Home Assistant entities) to Apple Home, as an alternative to ATH Bridge or a dedicated HomeBridge plugin.

If you do not already run Home Assistant and just want the simplest path to Twinkly-in-HomeKit for an older device, ATH Bridge or HomeBridge remains the more direct route, since it does not require setting up a full Home Assistant server first.

What Are the Alternatives for Generation I Twinkly Lights?

If you own a Generation I Twinkly light, or a PRO/Plus controller, you have a few bridge options besides ATH Bridge:

  • HomeBridge (self-managed, see the section below)
  • HOOBS (a HomeBridge appliance, similar concept to ATH Bridge)
  • Home Assistant, using its HomeKit Bridge integration
  • Homey Bridge, Athom's smart home hub, which also supports HomeKit

Each option gets you to the same place: your Twinkly lights showing up in the Apple Home app. The right one depends on whether you want plug-and-play hardware (ATH Bridge, HOOBS, Homey Bridge) or a self-hosted software project you maintain yourself (HomeBridge, Home Assistant).

You can also learn how to connect Govee lights to HomeKit or connect Philips Hue lights to HomeKit.

How Do You Connect Twinkly Lights to HomeKit Using Homebridge?

If you already run HomeBridge, you can connect Twinkly lights using the community plugin homeBridge- twinkly. This is an unofficial plugin, not built or maintained by Twinkly.

What Does the Plugin Support?

  • Turning Twinkly lights on or off
  • Adjusting brightness

Both Siri commands and Home app automations work once the plugin is set up.

Setup Steps

  • Install Homebridge on your network if you have not already. Follow the official HomeBridge documentation to get started.
  • Set up your Twinkly lights in the Twinkly app first, and make sure they are on the same Wi-Fi network as your HomeBridge server.
  • Install the plugin. Use the HomeBridge UI (homebridge-config-ui-x) and search for Twinkly.
  • Configure the plugin through the HomeBridge UI, or by editing config.json directly.
  • Restart HomeBridge. Your Twinkly lights should be auto discovered and appear as accessories.
  • Add the HomeBridge bridge to the Apple Home app, if you have not already, by scanning its setup code and following the on-screen prompts.

Configuration Options

allowBrightnessControl: Set to true to get a brightness slider instead of a simple on/off switch.

removeUnreachableDeviceMinutes: How long, in minutes, before an unreachable device is removed. 0 means it is never removed automatically.

Manual Setup for Older Plugin Versions

Versions of the plugin before 0.4.0 required adding each light manually rather than auto-discovering them. This method is deprecated but can still be useful if auto-discovery fails on your network.

Find the IP address of each Twinkly light in the Twinkly app. Then add the IP address to your config.json file.

What Can You Control Through HomeKit?

Control Native HomeKit (Gen II) ATH Bridge / Homebridge
On / Off Yes Yes
Brightness Yes Yes
Color Temperature Yes Limited
HomeKit Automations Yes Yes
Siri Voice Control Yes Yes
Remote Access Away from Home Yes, with a HomeKit hub Yes, with a HomeKit hub

Twinkly HomeKit Not Working? Troubleshooting Tips

  • Check your Wi-Fi. Both your iOS device and your Twinkly lights, or ATH Bridge, need to be on the same 2.4 GHz Wi-Fi network.
  • Reboot ATH Bridge. Unplug it for about 10 seconds, then plug it back in.
  • Reset your Twinkly lights. Hold the reset button for 10 seconds, then set them up again in the Twinkly app.
  • Re-add the device in HomeKit. Remove it from the Home app, then scan the HomeKit code again from the Twinkly app.
  • Update firmware and apps. Make sure both the Twinkly app and your lights’ firmware are current.
  • Reduce interference. Move ATH Bridge closer to your lights and reduce network congestion if possible.
  • Check your Apple ID. Confirm HomeKit is set up correctly and that you are signed in with the same Apple ID on every device you use to control your home.

Final Thoughts

Getting your Twinkly lights into Apple HomeKit is straightforward if you own a Generation II device, since HomeKit support is already built in. If you have an older Generation I device, or a PRO or Plus controller, a bridge like ATH Bridge gets you there with minimal setup.

If you already run Home Assistant, you have even more flexibility, since Twinkly's native Home Assistant integration and Home Assistant's own HomeKit Bridge can work together as another path into Apple Home.

Whichever route fits your setup, once your Twinkly lights are in HomeKit, you can control them from the Apple Home app, ask Siri, and build them into your existing automations and scenes.

FAQs About Twinkly HomeKit

Can Twinkly lights be controlled with HomeKit?
Yes, if your Twinkly device is Generation II with firmware 2.8.3 or later. Older Generation I devices, along with Twinkly PRO and Plus controllers, need a bridge like ATH Bridge or Homebridge to reach HomeKit.
How do I connect Twinkly lights to HomeKit?
Open the Twinkly app, go to your device's settings, select the HomeKit option, and scan the QR code with your iPhone or iPad's camera or the Home app. Choose a room, then tap Done. This only works on supported Generation II devices.
Can I connect Twinkly lights to Home Assistant?
Yes. Twinkly has an official Home Assistant integration built into Home Assistant core, separate from HomeKit. It supports on/off, brightness, and effects, and it does not require ATH Bridge or Homebridge.
Can I control Twinkly lights with Siri?
Yes, once your Twinkly lights are added to HomeKit, either natively or through a bridge, you can control them with Siri commands like "turn on the Christmas lights."
Do I need ATH Bridge if my Twinkly lights already work with HomeKit?
No. ATH Bridge is only needed for Twinkly devices that do not support HomeKit natively, such as Generation I lights or PRO/Plus controllers.
Are Twinkly lights compatible with other smart home platforms?
Yes. Twinkly works with Amazon Alexa, Google Home, and Home Assistant, in addition to Apple HomeKit.

Sarah Diyana

3 years of experience in smart home & HomeKit I want to share knowledge with anyone struggling to add incompatible devices to HomeKit. Experienced with many workarounds, write about the best methods.

• 8 min read