Matterbridge Airthings
June 19, 2025 · View on GitHub
A Matterbridge plugin for Airthings air quality monitors via the Airthings Consumer API.
Requirements
- Matterbridge
- One or more supported Airthings air quality monitors
- At least one Airthings SmartLink Hub (View Plus, View Radon)
Supported Devices
| Airthings Device | Serial Number |
|---|---|
| Airthings View Plus | 2960xxxxxx |
| Airthings View Radon | 2989xxxxxx |
| Airthings Wave Enhance | 3210xxxxxx |
| Airthings Wave Enhance | 3220xxxxxx |
| Airthings Wave Plus | 2930xxxxxx |
| Airthings Wave Radon | 2950xxxxxx |
| Airthings Wave Mini | 2920xxxxxx |
Note: Airthings Wave devices require an Airthings SmartLink Hub (View Plus, View Radon) to continuously push measurement data to the Airthings Cloud.
Configuration
| Field | Description |
|---|---|
| clientId | (required) Client ID generated in the Airthings Dashboard |
| clientSecret | (required) Client Secret generated in the Airthings Dashboard |
| refreshInterval | (optional) Interval in seconds for refreshing sensor data, default is 120s Note: The Airthings Consumer API has a rate limit of 120 requests per hour |
| debug | (optional) Enable debug logging, disabled by default |
How to request an Airthings API Client ID & Secret
Login to the Airthings Dashboard and go to Create New Application.
Matter Device Types
Temperature & Humidity Sensors
Air Quality Sensors
Air Quality Sensors are a composite of Radon, Particulate Matter (PM2.5), Volatile Organic Compound (VOC), Carbon Dioxide (CO₂), and Humidity sensors, depending on the sensors supported by your device and your plugin configuration. Air Quality values (Good, Fair, Poor) are based on Airthings-defined thresholds for each sensor.
| Sensor | 🟢 Good | 🟠 Fair | 🔴 Poor |
|---|---|---|---|
| Radon | <100 Bq/m³ | ≥100 and <150 Bq/m³ | ≥150 Bq/m³ |
| Particulate Matter (PM2.5) | <10 μg/m³ | ≥10 and <25 μg/m³ | ≥25 μg/m³ |
| Volatile Organic Compounds (VOCs) | <250 ppb | ≥250 and <2000 ppb | ≥2000 ppb |
| Carbon Dioxide (CO₂) | <800 ppm | ≥800 and <1000 ppm | ≥1000 ppm |
| Humidity | ≥30 and <60 % | ≥25 and <30 % ≥60 and <70 % | <25 % ≥70 % |
Notes:
- This plugin converts Volatile Organic Compound (VOC) measurements from ppb (units Airthings devices report) to µg/m³ (units expected by Apple HomeKit).