{"id":28831324,"url":"https://github.com/michaelahern/matterbridge-airthings","last_synced_at":"2026-01-20T16:58:50.099Z","repository":{"id":296727984,"uuid":"993915356","full_name":"michaelahern/matterbridge-airthings","owner":"michaelahern","description":"A Matterbridge plugin for Airthings air quality monitors via the Airthings Consumer API.","archived":false,"fork":false,"pushed_at":"2025-06-02T03:37:18.000Z","size":32,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T14:39:35.770Z","etag":null,"topics":["airthings","matter","matterbridge"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michaelahern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"michaelahern"}},"created_at":"2025-05-31T19:50:07.000Z","updated_at":"2025-06-07T19:15:41.000Z","dependencies_parsed_at":"2025-06-02T01:55:57.577Z","dependency_job_id":"b95d422d-c521-40c2-94fa-6ea69fa604a6","html_url":"https://github.com/michaelahern/matterbridge-airthings","commit_stats":null,"previous_names":["michaelahern/matterbridge-airthings"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/michaelahern/matterbridge-airthings","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelahern%2Fmatterbridge-airthings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelahern%2Fmatterbridge-airthings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelahern%2Fmatterbridge-airthings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelahern%2Fmatterbridge-airthings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michaelahern","download_url":"https://codeload.github.com/michaelahern/matterbridge-airthings/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelahern%2Fmatterbridge-airthings/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260701664,"owners_count":23049106,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airthings","matter","matterbridge"],"created_at":"2025-06-19T06:30:32.237Z","updated_at":"2026-01-20T16:58:50.094Z","avatar_url":"https://github.com/michaelahern.png","language":"TypeScript","funding_links":["https://github.com/sponsors/michaelahern"],"categories":[],"sub_categories":[],"readme":"# Matterbridge Airthings\n\n[![npm](https://badgen.net/npm/v/matterbridge-airthings)](https://www.npmjs.com/package/matterbridge-airthings)\n[![node](https://badgen.net/npm/node/matterbridge-airthings)](https://www.npmjs.com/package/matterbridge-airthings)\n[![downloads](https://badgen.net/npm/dt/matterbridge-airthings)](https://www.npmjs.com/package/matterbridge-airthings)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/michaelahern/matterbridge-airthings)\n\nA [Matterbridge](https://github.com/Luligu/matterbridge) plugin for [Airthings](https://www.airthings.com) air quality monitors via the  [Airthings Consumer API](https://consumer-api-doc.airthings.com/).\n\n## Requirements\n\n * [Matterbridge](https://github.com/Luligu/matterbridge)\n * One or more supported [Airthings](https://www.airthings.com/) air quality monitors\n * At least one Airthings SmartLink Hub ([View Plus](https://www.airthings.com/view-plus), [View Radon](https://www.airthings.com/view-radon))\n\n### Supported Devices\n\n| Airthings Device                                                     | Serial Number |\n| -------------------------------------------------------------------- | ------------- |\n| [Airthings View Plus](https://www.airthings.com/view-plus)           | 2960xxxxxx    |\n| [Airthings View Radon](https://www.airthings.com/view-radon)         | 2989xxxxxx    |\n| [Airthings Wave Enhance](https://www.airthings.com/wave-enhance)     | 3210xxxxxx    |\n| [Airthings Wave Enhance](https://www.airthings.com/wave-enhance)     | 3220xxxxxx    |\n| [Airthings Wave Plus](https://www.airthings.com/wave-plus)           | 2930xxxxxx    |\n| [Airthings Wave Radon](https://www.airthings.com/wave-radon)         | 2950xxxxxx    |\n| [Airthings Wave Mini](https://www.airthings.com/wave-mini)           | 2920xxxxxx    |\n\nNote: Airthings Wave devices require an Airthings SmartLink Hub ([View Plus](https://www.airthings.com/view-plus), [View Radon](https://www.airthings.com/view-radon)) to continuously push measurement data to the Airthings Cloud.\n\n## Configuration\n\nField                          | Description\n-------------------------------|------------\n**clientId**                   | (required) Client ID generated in the [Airthings Dashboard](https://consumer-api-doc.airthings.com/dashboard)\n**clientSecret**               | (required) Client Secret generated in the [Airthings Dashboard](https://consumer-api-doc.airthings.com/dashboard)\n**refreshInterval**            | (optional) Interval in seconds for refreshing sensor data, default is 120s\u003cbr/\u003e_Note: The Airthings Consumer API has a [rate limit of 120 requests per hour](https://consumer-api-doc.airthings.com/docs/api/rate-limit)_\n**debug**                      | (optional) Enable debug logging, disabled by default\n\n### How to request an Airthings API Client ID \u0026 Secret\n\nLogin to the [Airthings Dashboard](https://consumer-api-doc.airthings.com/dashboard) and go to *Create New Application*.\n\n## Matter Device Types\n\n### Temperature \u0026 Humidity Sensors\n\n### Air Quality Sensors\n\nAir 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](https://help.airthings.com/en/articles/5367327-view-understanding-the-sensor-thresholds) for each sensor.\n\nSensor                            | 🟢 Good       | 🟠 Fair                            | 🔴 Poor            |\n----------------------------------|---------------|------------------------------------|--------------------|\nRadon                             | \u003c100 Bq/m³    | ≥100 and \u003c150 Bq/m³                | ≥150 Bq/m³         |\nParticulate Matter (PM2.5)        | \u003c10 μg/m³     | ≥10 and \u003c25 μg/m³                  | ≥25 μg/m³          |\nVolatile Organic Compounds (VOCs) | \u003c250 ppb      | ≥250 and \u003c2000 ppb                 | ≥2000 ppb          |\nCarbon Dioxide (CO₂)              | \u003c800 ppm      | ≥800 and \u003c1000 ppm                 | ≥1000 ppm          |\nHumidity                          | ≥30 and \u003c60 % | ≥25 and \u003c30 % \u003cbr /\u003e ≥60 and \u003c70 % | \u003c25 % \u003cbr /\u003e ≥70 % |\n\nNotes:\n* This plugin converts Volatile Organic Compound (VOC) measurements from ppb (units Airthings devices report) to µg/m³ (units expected by Apple HomeKit).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelahern%2Fmatterbridge-airthings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelahern%2Fmatterbridge-airthings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelahern%2Fmatterbridge-airthings/lists"}