Homebridge plugin for showing air condition data

Usage no npm install needed!

<script type="module">
  import homebridgeAirly from 'https://cdn.skypack.dev/homebridge-airly';



NPM Version

Homebridge plugin that is showing information about air quality from Airly API.

Project is based on homebridge-weather and homebridge-arinow.

Currently Airly is supporting only Polish localizations.


  1. Install Homebridge using: (sudo) npm install -g --unsafe-perm homebridge.
  2. Install this plugin using: (sudo) npm install -g homebridge-airly.
  3. Get API Key from Airly. Login here https://developer.airly.eu/login and generate it.
  4. Find out your coordinates (latitude and longitude). Based on that information Airly will show measurements from nearest sensor. You can use this page https://www.latlong.net/.
  5. Update your configuration file like the example below.

This plugin is returning data such as: AQI (Air Quality Index), PM2.5, PM10.


Example config.json

"accessories": [
          "accessory": "Air",
          "apikey": "YOUR_API_KEY",
          "latitude": "YOUR_LATITUDE",
          "longitude": "YOUR_LONGITUDE",
          "name": "Airly Air Quality"

Config file


  • accessory must be "Air" (required).
  • apikey API key from Airly Developers (required).
  • latitude String with your latitude e.g. "52.229676" (required).
  • longitude String with your longitude e.g. "21.012229" (required).
  • name Is the name of accessory (required).