PurpleAir
homebridge-purpleair-sensor · v3.3.0
Adds PurpleAir air quality sensors to HomeKit via the PurpleAir API or local network.
What it says it supports
Brands
- PurpleAir
Devices it names
- PurpleAir sensors
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Plugin reads PurpleAir sensors; v3 added ALT-CF3 conversion and Homebridge 2.0 support. One user reports AQI readings differ from the PurpleAir map.
- Works2
- Partly works1
| Device | Status | What they said | Source |
|---|---|---|---|
| PurpleAir air quality sensor | Works | Accurate; Homebridge plugin can also use a nearby public stationSaved copyMaybe Purpleair? Yes, they are very accurate and can be used indoor or outdoors. No, they don’t have a native HomeKit integration. Yes, there is a Homebridge plugin for it. Yes, if a local purpleair station near your house is visible on the map, you can use that one and show it in your HomeKit house. For free. It looks like this in HomeKit: https://imgur.com/a/vKic6Fm/ Personally, I built my own air quality meter and connected it to HomeKit. Similar to purpleair (but not similarly, costs much less than $225) I used two ~$20 sensors and an arduino to get accurate PM readings. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-11 |
| PurpleAir sensor | Works | Nearby PurpleAir sensors give AQI in HomeKit via pluginSaved copySearch your neighborhood for Purpleair sensors. Then add one of those to your HomeKit via Homebridge plugin. Search for “purpleair homebridge” You get an AQI displayed in any room you’d like - without spending $200 for external air measurement. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-08 |
| PurpleAir air quality sensor | Partly works | Works, but a user saw HomeKit show Excellent where PurpleAir map showed AcceptableSaved copyThere always seems to be a discrepancy between the PurpleAir Map and Homekit. Even if I try to match PurpleAir Map, No coversion, report AQI - I am getting sensors around me all reporting Excellent in Homekit but Acceptable on PurpleAir. Excerpt saved from GitHub on 2026-10-22. | Issue #60 · 2023-12 |
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
PurpleAir API or direct local sensor
You’ll need
- PurpleAir API key for remote sensors (inferred)
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.6.0 || ^1.8.5 || ^2.0.0 || ^2.0.0-beta.23 || ^2.0.0-alpha.37 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | PurpleAirSensor |
| License | Apache-2.0 |
Community signals
| Downloads a week | 28 |
|---|---|
| Downloads a month | 142 |
| GitHub stars | 33 |
| Open issues | 2 |
| Closed issues | 31 |
| Last code push | 2026-10-20 |
| Latest version | 3.3.0 (2026-03-06) |
| First published | 2020-08-30 |
| 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.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirQualitySensor
- HumiditySensor
- TemperatureSensor
