Repository navigation
Home
The original Homebridge integration for Advantage Air systems.
Welcome to the Homebridge Advantage Air Wiki!
This Wiki provides information, guides and resources for integrating compatible Advantage Air air conditioning systems and MyPlace lighting into Apple Home.
Native v4 is a standalone Homebridge plugin, with automatic accessory discovery and no requirement for Cmd4, shell scripts or the original Config Creator.
Important
Native v4 Beta 1 is being prepared for release. The npm package has not yet been published. Please wait for the official announcement before installing and review the testing and backup guidance.
New to Homebridge Advantage Air? Start here:
- Installation & Beta Testing — Installation preparation, compatibility, testing and backup precautions.
- Migrating from v3 — Moving from the original Cmd4 integration while preserving your existing setup.
- Main Project README — Supported features, screenshots and a quick installation overview.
Native v4 Beta 1 includes:
- Air conditioning thermostat with linked fan-speed control
- Separate ventilation and dry-mode controls
- Temperature-sensor and sensorless percentage-zone configurations
- MyZone selection on compatible systems
- Native air conditioning countdown timer
- Individual MyPlace relay and dimmer lights
Compatibility across different controllers, firmware versions and physical MyPlace devices is still being confirmed. Please share your experiences to help expand our verified compatibility information.
Having trouble, or looking for advice?
- GitHub Discussions — Ask questions, exchange ideas and help other users.
- Beta Testing & Feedback — Share successful installations, compatibility reports and testing experiences.
- Diagnostics & Logging — Understand plugin logs and troubleshoot controller communication.
- GitHub Issues — Report reproducible bugs and technical problems.
Please remove IP addresses, credentials, pairing codes and other private information before sharing logs or screenshots.
Still using the original Cmd4-based plugin? We've preserved the historical documentation for you.
- Legacy v3 Overview — Original supported systems, accessories and limitations.
- Config Creation — Original Cmd4 configuration instructions and Config Creator guide.
- v3-maintenance Branch — Preserved v3 source code and history.
Native v4 and legacy v3 are separate packages. Installing native v4 does not automatically migrate existing Apple Home accessories, rooms or automations.
Homebridge Advantage Air is an independent community project and is not affiliated with or endorsed by Advantage Air. It is developed and maintained in spare time, with community contributions and feedback always appreciated.