Homebridge Airthings
A Homebridge plugin for Airthings air quality monitors via the Airthings Consumer API.
Requirements
- Homebridge
- One or more supported Airthings air quality monitors
- At least one Airthings SmartLink Hub (Hub, View Plus, View Pollution, View Radon)
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
- Login to the Airthings Dashboard
- Navigate to Integrations, then Request API Client
- 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