Atomberg
dasshubham762/atomberg-integration · vv2.2.3
Home Assistant integration for Atomberg Fans.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
fan | Fan | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Atomberg fans work through the cloud API with local UDP control added later (internet still needed at setup); Aris Contour LED brightness is missing.
- Works2
- Partly works1
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Atomberg Gorilla Efficio, Renesa, Aris, Erica fans (IR) | Works Local | IR control via NEC codes; assumed state only, needs line of sightSaved copy… of sight required, The IR emitter must be able to "see" the fan's IR receiver. Obstructions will prevent commands from being received. NEC protocol, Atomberg fans use NEC protocol with address 0xF300. The IR codes are based on community-decoded values and are compatible with Gorilla Efficio, Renesa, Aris, Erica, and other Atomberg models. Excerpt saved from the README on 2026-10-23. | README | |
| Atomberg network fans (local UDP control) | Works Local | Local controls released after request; internet needed to initialiseSaved copy… duplicate feature request of previous feature requests. ### Is your feature request related to a problem? Please describe. For now, it uses cloud api. Local integration will be much faster and reliable. ### Describe the solution you'd like Atomberg local Home Assistant integration will be much appreciated. ### Describe alternatives you've considered local integration ### Additional context Atomberg local Home Assistant integration will be much appreciated. Excerpt saved from GitHub on 2026-10-23. | Issue #32 · 2025-05 | |
| Atomberg Aris Contour ceiling fan | Partly works | Fan listed and controllable, but LED shows only on/off, no brightnessSaved copyHey! I am unable to add my Aris Contour to HA. Is there any chance you could help me? I am a complete newbie. Excerpt saved from GitHub on 2026-10-23. | Issue #46 · 2026-04 | |
| Atomberg Aris Starlight (series I1/I5) fan LED | Requested | Colour temperature control for the fan LED proposed; LED only brightness plus effectsSaved copyProblem On fans with color-controllable LEDs (Aris Starlight, series I1/I5), the LED is currently exposed as a brightness-only light with three effects (Daylight/Cool/Warm). Because effects are not a color mode: - There is no color temperature selector in the Home Assistant UI. - Bridges such as HomeKit (Home Assistant HomeKit Bridge / Homebridge) don't expose any temperature control at all, since HomeKit has no concept of effects. ## Changes ### `light.py`, expose the LED as a proper color-temperature light - Devices that support color effects now declare `ColorMode.COLOR_TEMP` with a 2700 … Excerpt saved from GitHub on 2026-10-23. | PR #70 · 2026-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Details
| Installs (analytics) | 189 (0.03%) |
|---|---|
| GitHub stars | 84 |
| Latest version | v2.2.3 (2026-08-03) |
| Set up in the UI | Yes |
| Maintainers | @dasshubham762 |
| License | MIT |
Limitations from the README
- One-way communication, IR is transmit-only. The integration tracks assumed state internally but cannot detect if the fan is controlled by the physical remote. If you use the physical remote, resync the entity in Home Assistant by toggling it.
- Line of sight required, The IR emitter must be able to "see" the fan's IR receiver. Obstructions will prevent commands from being received.
- NEC protocol, Atomberg fans use NEC protocol with address 0xF300. The IR codes are based on community-decoded values and are compatible with Gorilla Efficio, Renesa, Aris, Erica, and other Atomberg models.
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
