Nanoleaf
The Nanoleaf integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control and monitor Nanoleaf Light Panels, Canvas, Shapes, Elements, Lines, and Essentials lights. The Nanoleaf Remote is not supported.
Nanoleaf Essentials lights do not send state changes to Home Assistant, so changes made outside of Home Assistant (for example in the Nanoleaf app) can take up to a minute to show up. Controlling Nanoleaf Essentials lights over Thread and Bluetooth is also possible using the HomeKit Controller integration.
Configuration
To add the Nanoleaf device to your Home Assistant instance, use this My button:
Nanoleaf 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:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Nanoleaf.
-
Follow the instructions on screen to complete the setup.
Transition and brightness
When using a transition in an action (such as light.turn_on), the transition is only applied to brightness and does not apply to color. When an action has a transition set, but no brightness is included, the light will automatically transition to 100% brightness.
Screen mirroring modes
For the Nanoleaf 4D, the Screen Mirroring modes (1D, 2D, 3D, and 4D) are available as effects of the light entity. Selecting one of them activates the mode, and the active mode is shown as the current effect.
Touch gestures
Devices with touch support expose a Touch gesture event entity. You can use it in automations to respond to a single tap, double tap, swipe up, swipe down, swipe left, or swipe right.
Removing the integration
This integration follows standard integration removal, no extra steps are required.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- Next to the entry you want to remove, select the three dots
menu. Then, select Delete. - Depending on the integration, the entries are listed under one of the following headings:
- Devices
- Hubs
- Services
- Integration entries
- Depending on the integration, the entries are listed under one of the following headings:
- To confirm, select Delete.
- Home Assistant also deletes the devices and entities of the entry.
- If Home Assistant asks you to restart, restart Home Assistant.
- If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
- If you keep them, Home Assistant uses them automatically when you add the integration again.
- To delete them later, refer to Deleting application credentials.