Why revive the project?

Homebridge Airly 2 was born out of the need to monitor air quality inside HomeKit without buying extra hardware. After a couple of quiet years I refreshed the codebase, updated dependencies, removed known vulnerabilities and aligned the integration with the current Airly API. The plugin is reliable again and ready for modern Homebridge setups.

What changed in the latest update?

  • support for current Homebridge and Node.js releases,
  • new HTTP backend that talks directly to the official Airly v2 API (no extra libraries required),
  • cleaner logs with more helpful error messages,
  • explicit log entry when no Airly sensor is available nearby.

Key features

  • reads the CAQI air quality index and main pollutants such as PM2.5 and PM10,
  • exposes the readings as native HomeKit accessories (air quality sensor),
  • handles multiple locations simultaneously,
  • caches responses and keeps API calls within Airly rate limits.

Getting started

  1. Create an API key in the Airly developer portal or inside your Airly account.
  2. Install the package:
npm install -g homebridge-airly2

or

hb-service add homebridge-airly2
  1. Add the accessory to the Homebridge config.json:
{
  "accessories": [
    {
      "accessory": "Air2",
      "apikey": "YOUR_API_KEY",
      "latitude": "YOUR_LATITUDE",
      "longitude": "YOUR_LONGITUDE",
      "maxdistance": 3,
      "name": "Airly Air Quality"
    }
  ]
}

If you use the plugin in your Homebridge setup, let me know on GitHub or drop me a line—I would love to hear how Homebridge Airly 2 performs in the wild.