Skip to content

Installation

Jump to bottom
Ben edited this page Jul 19, 2026 · 1 revision

1. Install

Homebridge UI

Simply go to the 'Plugins' page, search Air and install the @homebridge-plugins/homebridge-air plugin.

Manually

This will only work if you are using a platform which installs plugins globally.

sudo npm i -g @homebridge-plugins/homebridge-air

2. Configure

If you use the Homebridge UI then a configuration screen will appear after installing the plugin where you can add your air-quality locations, choosing AirNow or AQICN as the provider and entering that provider's API key.

  1. Obtain an API key from AirNow or Aqicn as applicable for your location.
  2. 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.
  3. Click Save and restart Homebridge.

See the Configuration page for JSON configuration templates and other optional settings if editing the configuration manually.

3. Restart

And voila, your configured air-quality locations should be added to your Homebridge instance.

Setup

Help/About

Clone this wiki locally