Control your Broadlink AC unit via Broadlink Cloud through homebridge.
npm install homebridge-broadlink-cloud-acControl your Broadlink AC unit through Homebridge.
If you find this plugin helpful, consider supporting its development:
- Auto-discovery: Automatically finds and adds all AUX AC units in your account
- Cloud-based control: Works with any AUX AC unit that's connected to the AUX Cloud service
- Full HomeKit integration: Control power, temperature, mode, fan speed, and swing
- Device management: Hide specific devices using device IDs or friendly names
- Automatic reconnection: Handles session expiry and network issues
- Node.js 18.0.0 or later
- Homebridge 1.6.0 or later
- An AUX AC unit connected to the AUX Cloud service
- AUX Cloud account (AC Freedom app account)
``bash`
npm install -g homebridge-broadlink-cloud-ac
Or install through the Homebridge UI.
Recommended: Use the platform configuration to automatically discover all your AUX Cloud devices:
`json`
{
"platform": "AuxCloudPlatform",
"name": "AUX Cloud",
"email": "your@email.com",
"password": "your_password",
"region": "eu"
}
You can still configure individual devices manually if preferred:
`json`
{
"accessory": "AirCondionerAccessory",
"name": "Living Room AC",
"email": "your@email.com",
"password": "your_password",
"region": "eu",
"deviceId": "your_device_endpoint_id"
}
#### Check plugin logs
1. Configure the plugin with a placeholder deviceId
2. Check the Homebridge logs during startup
3. The available devices will be logged
| Option | Type | Required | Default | Description |
|--------|------|----------|---------|-------------|
| name | string | Yes | "AUX Cloud" | Name for the platform |email
| | string | Yes | - | Your AUX Cloud account email |password
| | string | Yes | - | Your AUX Cloud account password |region
| | string | No | "eu" | Your AUX Cloud region ("eu", "usa", or "cn") |autoDiscover
| | boolean | No | true | Automatically discover and add all devices |hiddenDevices
| | string[] | No | [] | List of device IDs to hide from HomeKit |discoveryInterval
| | number | No | 0 | Re-discovery interval in minutes (0 = disabled) |
With the platform configuration, you can hide specific devices from HomeKit by adding their device IDs to the hiddenDevices array:
`json`
{
"platform": "AuxCloudPlatform",
"name": "AUX Cloud",
"email": "your@email.com",
"password": "your_password",
"region": "eu",
"hiddenDevices": [
"device_endpoint_id_1",
"Bedroom AC",
"device_endpoint_id_3"
]
}
You can use either:
- Device endpoint ID: The unique identifier (e.g., "1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p")
- Friendly name: The device name as shown in the AC Freedom app (e.g., "Bedroom AC")
- eu: Europe - https://app-service-deu-f0e9ebbb.smarthomecs.de
- usa: United States - https://app-service-chn-31a93883.ibroadlink.com`
- cn: China -