Matterbridge Airthings

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 120sNote: 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).