Homebridge TestFlight
AUX, AC Freedom

AUX Cloud

homebridge-aux-cloud · v0.0.13

VerifiedLocal + cloudMatterHomebridge 2.0

Adds AUX air conditioners and heat pumps to HomeKit via LAN, cloud or both.

View on npm Source code

What it says it supports

Brands

  • AUX
  • AC Freedom

Devices it names

  • AUX air conditioners
  • AUX heat pumps

Shows up in Apple Home as from its README

What people report

Works with AUX AC units via AUX Cloud with email login; phone-number accounts and AC Freedom accounts fail login.

  • Not working1
DeviceStatusWhat they saidSource
AUX air conditioner (AC Freedom app account)Not workingLogin errors -1005/-1006/-1008 with phone-number or other-cloud accounts
Saved copy
Good news, I think we can officially call AUX Home support done 😄 I’ve finished testing the fork against my actual AUX units and everything is now working reliably. AUX Home is now implemented as a separate provider while still reusing the existing AUX/Broadlink architecture as much as possible. Authentication, device/family discovery, shared devices, state polling/updates and control commands are all working with the AUX Home backend. I’ve tested it with two physical ACs, including power, target temperature, operating modes, fan controls and state changes coming back from AUX Cloud. I also …

Excerpt saved from GitHub on 2026-10-22.

Issue #7 · 2026-06

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local + cloud

Broadlink UDP on port 80 locally; AUX Cloud API optionally

You’ll need

  • Device MAC address for LAN mode
  • AUX Cloud account for cloud mode

Compatibility

Verified by HomebridgeYes
Homebridge versions^1.8.0 || ^2.0.0
Homebridge 2.0Yes
Node.js^20.15.1 || ^22 || ^24
Settings in Homebridge UIYes
MatterYes (uses the Homebridge 2 Matter API)
Platform nameAuxCloudPlatform
LicenseMIT

Community signals

Downloads a week18
Downloads a month199
GitHub stars0
Open issues1
Closed issues1
Last code push2026-10-13
Latest version0.0.13 (2026-07-29)
First published2025-10-23
Releases117

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

Caveats from the README

  • Only one UDP session per device
  • Cloud+LAN falls back after 3 LAN failures

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • HeaterCooler
  • Switch

Sources

Similar plugins