@homebridge-plugins/homebridge-air
v2.1.2
Published
The Air plugin allows you to monitor the current air quality for your location from HomeKit and Siri, via AirNow or AQICN.
Readme
homebridge-air
Homebridge plugin to integrate air quality data into HomeKit
Plugin Information
- This plugin allows you to view live air quality data for your location within HomeKit. The plugin:
Setup
- Installation
- Search for "Air" on the plugin screen of the Homebridge UI and click Install.
- Configuration
- Obtain an API key from AirNow or Aqicn as applicable for your location.
- Enter your provider, API key, city and location details in the plugin settings.
- City names can be ambiguous, so also enter your latitude and longitude for accuracy (4 decimal places is sufficient). AirNow also requires your zip code.
- Click Save and restart Homebridge.
Features
- Measurements retrieved are PM2.5, PM10 and O3 for AirNow. AQICN adds NO2, SO2 and CO.
- The Home app shows the overall air quality; the Eve app shows more of the individual measurements.
- Matter support is available when running Homebridge v2.0+ with Matter enabled:
options.enableMatter: trueexplicitly requests Matter. If Matter is unavailable or disabled, the plugin logs a warning and falls back to HAP.options.preferMatter: trueuses Matter when available and enabled, but silently falls back to HAP otherwise.- Switching between HAP and Matter removes stale cached accessories from the previous mode.
Help/About
Credits
- To @donavanbecker: the original creator and maintainer of this plugin.
- To @ToddGreenfield: the author of the original accessory-based plugin homebridge-airnow.
- To the creators/contributors of Homebridge who make this plugin possible.
Disclaimer
- I am in no way affiliated with AirNow, AQICN or the World Air Quality Index Project, and this plugin is a personal project that I maintain in my free time.
- Use this plugin entirely at your own risk - please see licence for more information.
