{"id":17640567,"url":"https://github.com/homebridge-plugins/homebridge-air","last_synced_at":"2026-02-26T03:51:40.953Z","repository":{"id":255849530,"uuid":"853133366","full_name":"homebridge-plugins/homebridge-air","owner":"homebridge-plugins","description":"Homebridge plugin for AirNow Web-API Air Quality Sensor","archived":false,"fork":false,"pushed_at":"2025-03-05T04:19:37.000Z","size":498,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"latest","last_synced_at":"2025-04-14T10:06:06.035Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/homebridge-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"donavanbecker","custom":"paypal.me/DonavanBecker"}},"created_at":"2024-09-06T03:55:49.000Z","updated_at":"2025-03-05T04:19:07.000Z","dependencies_parsed_at":"2024-09-07T13:35:33.964Z","dependency_job_id":"cf07a06b-09cc-4be4-9617-b187dfb3f383","html_url":"https://github.com/homebridge-plugins/homebridge-air","commit_stats":null,"previous_names":["donavanbecker/homebridge-air"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homebridge-plugins%2Fhomebridge-air","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homebridge-plugins%2Fhomebridge-air/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homebridge-plugins%2Fhomebridge-air/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homebridge-plugins%2Fhomebridge-air/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/homebridge-plugins","download_url":"https://codeload.github.com/homebridge-plugins/homebridge-air/tar.gz/refs/heads/latest","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248860285,"owners_count":21173342,"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":[],"created_at":"2024-10-23T06:02:30.073Z","updated_at":"2026-02-26T03:51:40.929Z","avatar_url":"https://github.com/homebridge-plugins.png","language":"TypeScript","funding_links":["https://github.com/sponsors/donavanbecker","paypal.me/DonavanBecker","https://paypal.me/donavanbecker"],"categories":[],"sub_categories":[],"readme":"\u003cspan align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/homebridge/verified/blob/master/verified-plugins.json\"\u003e\u003cimg alt=\"homebridge-verified\" src=\"https://raw.githubusercontent.com/homebridge-plugins/homebridge-air/latest/branding/Homebridge_x_Air.svg?sanitize=true\" width=\"350px\"\u003e\u003c/a\u003e\n\n# Homebridge Air\n\n\u003ca href=\"https://www.npmjs.com/package/homebridge-air\"\u003e\u003cimg title=\"npm version\" src=\"https://badgen.net/npm/v/homebridge-air?icon=npm\u0026label\" \u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/homebridge-air\"\u003e\u003cimg title=\"npm downloads\" src=\"https://badgen.net/npm/dt/homebridge-air?label=downloads\" \u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/8fpZA4S\"\u003e\u003cimg title=\"discord-air\" src=\"https://badgen.net/discord/online-members/8fpZA4S?icon=discord\u0026label=discord\" \u003e\u003c/a\u003e\n\u003ca href=\"https://paypal.me/donavanbecker\"\u003e\u003cimg title=\"donate\" src=\"https://badgen.net/badge/donate/paypal/yellow\" \u003e\u003c/a\u003e\n\n\u003cp\u003eThe Homebridge \u003ca href=\"https://www.airnow.gov/\"\u003eAir\u003c/a\u003e\nplugin allows you monitor the current AirQuality for your Zip Code from HomeKit and Siri.\n\u003c/p\u003e\n\n\u003c/span\u003e\n\n## Installation\n\n1. Search for \"Air\" on the plugin screen of [Homebridge Config UI X](https://github.com/oznu/homebridge-config-ui-x).\n2. Click **Install**.\n\n## Configuration\n\n1. Login / create an account at https://www.airnow.gov/ or at https://aqicn.org/api/ as applicable for your location\n\n\u003cp align=\"center\"\u003e\n\n\u003cimg src=\"https://user-images.githubusercontent.com/9875439/133934622-05a9c19e-c5ba-46ee-b0db-0748420813d7.png\" width=\"450px\"\u003e\n\n\u003c/p\u003e\n\n2. Select your Provider: AirNow or Apicn\n3. Enter your AirNow.gov or Aqicn API Key\n4. Enter your City and Latitude / Longitude (4 decimal places is sufficient). Note that City may be ambiguous, so you should always enter Latitude and Longitude for location accuracy\n5. Click Save\n6. Restart Homebridge\n\n## Supported Air Quality Providers\n\nCurrently supports AQI Services:\n\n- [AirNow](https://www.airnow.gov/) which is limited to the USA. A valid ZipCode is required.\n- [Aqicn](https://www.aqicn.org/) which has international support, provided by the [World Air Quality Index Project](http://waqi.info/).\n\nDepending on where exactly you would like to monitor AQI, one service may be more appropriate than the other.\n\n## Supported Air Quality Features\n\nThis plugin will create an AirQualitySensor element. The Home app works well, but the Eve app seems to show more measurements. Measurements retrieved are PM2.5, PM10, \u0026 O3 for AirNow. Aqicn adds NO2, SO2, CO...\n\n## Contributing\n\nWe welcome contributions! Please note our **beta branch strategy**:\n\n- **All PRs must target a beta branch first** (format: `beta-X.Y.Z`)\n- **Issues must have semantic versioning labels** (`patch`, `minor`, `major`) before assignment\n- **Use our helper script** to create beta branches: `./scripts/create-beta-branch.sh`\n- **See our [Contributing Guide](./CONTRIBUTING.md)** for detailed instructions\n\nFor GitHub Copilot users, please review our [Copilot Instructions](./.github/copilot-instructions.md).\n\n## Thanks\n\nThank you to [ToddGreenfield](https://github.com/ToddGreenfield) for the the work done on the accesorry based plugin [homebridge-airnow](https://github.com/ToddGreenfield/homebridge-airnow/blob/master/README.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomebridge-plugins%2Fhomebridge-air","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhomebridge-plugins%2Fhomebridge-air","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomebridge-plugins%2Fhomebridge-air/lists"}