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,
  • Complete rewrite of the HTTP backend, removing all third-party libraries for enhanced security and performance.
  • cleaner logs with more helpful error messages,
  • explicit log entry when no Airly sensor is available nearby.

Key features

  • Zero Dependencies: For your security and peace of mind, the plugin has zero external production dependencies, eliminating risks from third-party libraries.
  • 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.