/homebridge-airthings

A Homebridge plugin for Airthings air quality monitors via the Airthings Consumer API.

Primary LanguageTypeScriptISC LicenseISC

Homebridge Airthings

verified-by-homebridge npm npm License Build Donate

A Homebridge plugin for Airthings air quality monitors via the Airthings Consumer API.

Requirements

Supported Devices

Airthings Device Serial Number
Airthings View Plus 2960xxxxxx
Airthings View Pollution 2980xxxxxx
Airthings View Radon 2989xxxxxx
Airthings Wave Plus 2930xxxxxx
Airthings Wave Radon 2950xxxxxx
Airthings Wave Mini 2920xxxxxx

Note: Airthings Wave devices require an Airthings SmartLink Hub (Hub or View Series device) to continuously push measurement data to the Airthings Cloud.

Configuration

Example accessory config in the Homebridge config.json:

"accessories": [
  {
    "accessory": "Airthings",
    "name": "Living Room Airthings View Plus",
    "clientId": "00000000-0000-0000-0000-000000000000",
    "clientSecret": "11111111-1111-1111-1111-111111111111",
    "serialNumber": "2960123456"
  }
]

Configuration Details

Field Description
accessory (required) Must be "Airthings"
name (required) Name for the device in HomeKit
clientId (required) API Client ID generated in the Airthings Dashboard
clientSecret (required) API Client Secret generated in the Airthings Dashboard
serialNumber (required) Serial number of the device

How to request an Airthings API Client ID & Secret

  1. Login to the Airthings Dashboard
  2. Navigate to Integrations, then Request API Client
  3. Create a new API Client with the following configuration:
    • Name: Homebridge
    • Resource Scope: read:device:current_values
    • Access Type: confidential
    • Flow Type: Client Credentials (machine-to-machine)
    • Enable: On