About
Philips Air+ is an integration for Philips Air+ cloud-only fans, verified against the CX3550/01 stand fan. These fans have no local API, so the integration talks to the vendor's cloud and signs in with the Philips account email and a code sent by email. It adds a fan entity for each bound device, with controls for power, speed, sleep and natural presets, and oscillation. Number, switch and sensor entities cover the timer duration, key beep, timer on and off, timer remaining, signal strength, uptime and free memory. Setup runs in the UI and asks for a Philips Air+ app APK file, from which a signing value is extracted locally and kept only in the Home Assistant instance. A diagnostics download is available for bug reports.
Automatic summary of the README and code of Ka3seBr0t/HA_Philips_Air_Plus. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Fans
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Philips Air+ — APK
- Philips Air+ APK file (.apk / .apkm / .xapk)
Philips Air+ — Code
- Verification code
Philips Air+ — Email
- Email address
Texts from the code of Ka3seBr0t/HA_Philips_Air_Plus.
Entities
- NumbersTimer duration
- SensorsTimer remaining, Signal strength, Uptime, Free memory
- SwitchesKey beep, Timer
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
A Home Assistant custom integration for Philips Air+ cloud-only fans, verified against the CX3550/01 ("Series 3000" stand fan, Air Matters app). These fans have no local API — they're controlled via an AWS IoT device shadow over MQTT-over-WSS, behind Philips' client-signed air-matters/gaoda auth chain.
Not the upstream Versuni/HomeID integration (e.g. ShorMeneses/philips-airplus-homeassistant). That one returns "no devices found" for the CX3550 — it targets a different backend (the AC air-purifier line). This integration speaks the fan's actual cloud protocol.
Shows in Vulpo
Quick Toggle card, Fan card, Chart card, Apple Watch, Control Center.Information
- Installs
- 143 sharing analytics
- GitHub stars
- 4
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v0.3.2,
- Category
- Climate, Air purifiers and humidifiers
- Kind
- Marketplace integration
- Brand
- Philips
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
philips_airplus- Issues
- Report an issue
More from Philips
Philips AirPurifier (with CoAP)3k installs · 💨 Philips AirPurifier custom component for Home Assistant. Suppo…Open
Philips Hue Play Sync devices2.2k installs · Custom integration for Home Assistant to control the Philips Hu…Open
