Philips Air Purifier
homebridge-philips-air-purifier-complete · v4.1.1
Adds Philips air purifiers to HomeKit with fan modes, PM2.5 air quality, display light, child lock and filter status.
What it says it supports
Brands
- Philips
Devices it names
- Philips Air Purifier AC1715 (AC1xxx HTTP)
- AC2xxx CoAP models
- HomeID/Condor local HTTP devices
- Air+ account devices
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Philips AC1715/11 cloud setup failed via wrong Gigya endpoint; CLI setup fixed in 4.0.0, UI wizard still reported failing.
- Partly works2
| Device | Status | What they said | Source |
|---|---|---|---|
| Philips AC1715/11 air purifier | Partly works | CLI setup works since 4.0.0; Homebridge UI wizard still failsSaved copyI found the cause of the `Gigya getIDs failed: Permission denied` error in v3.3.1. In `scripts/airplus_setup.py`, the `GET_IDS_ENDPOINT` is currently set to: [code] That endpoint appears to be incorrect. Philips HomeID/Gigya expects: [code] After changing `/accounts.socialize.getIDs` → `/socialize.getIDs`, the email verification flow completed successfully and I was able to obtain the Air+ token. But then I get a new error: [09/08/2026, 18:14:50] [Philips Air Purifiers] Starting airplus-cloud daemon: /var/lib/homebridge/node_modules/homebridge-philips-air-purifier-complete/.venv/bin/python3 … Excerpt saved from GitHub on 2026-10-22. | Issue #31 · 2026-08 |
| Philips air purifier | Partly works | Plugin exists, but replacement filters hard to find and expensiveSaved copyI have a plugin for the Philips ones. Can’t say I recommend them as replacement filters are nearly impossible to find and are very expensive when they do turn up. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-01 |
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
Local CoAP/HTTP by device IP; Philips Air+ account email login used for setup of newer models
You’ll need
- Device IP address
- Python 3.11+
- Node.js 24+
- Homebridge 2.0+
- Philips Air+ account (for Air+ models)
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | >=2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | >=24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | PhilipsAirPurifier |
| License | MIT |
Community signals
| Downloads a week | 32 |
|---|---|
| Downloads a month | 134 |
| GitHub stars | 2 |
| Open issues | 0 |
| Closed issues | 1 |
| Last code push | 2026-10-22 |
| Latest version | 4.1.1 (2026-10-13) |
| First published | 2026-05-17 |
| Releases | 28 |
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
- Air+ users must re-run setup after 4.0.0; use 4.0.1+ for UI wizard
- HTTP models poll every 10s
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirPurifier
- AirQualitySensor
- FilterMaintenance
- Lightbulb
- Switch





