@homebridge-plugins/homebridge-air
Version:
The AirNow plugin allows you to monitor the current AirQuality for your Zip Code from HomeKit and Siri.
76 lines (75 loc) • 10.5 kB
HTML
<html class="default" lang="en" data-base="./"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>@homebridge-plugins/homebridge-air</title><meta name="description" content="Documentation for @homebridge-plugins/homebridge-air"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="assets/style.css"/><link rel="stylesheet" href="assets/highlight.css"/><script defer src="assets/main.js"></script><script async src="assets/icons.js" id="tsd-icons-script"></script><script async src="assets/search.js" id="tsd-search-script"></script><script async src="assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="index.html" class="title">@homebridge-plugins/homebridge-air</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><h1>@homebridge-plugins/homebridge-air</h1></div><div class="tsd-panel tsd-typography"><span align="center">
<p><a href="https://github.com/homebridge/verified/blob/master/verified-plugins.json"><img alt="homebridge-verified" src="https://raw.githubusercontent.com/homebridge-plugins/homebridge-air/latest/branding/Homebridge_x_Air.svg?sanitize=true" width="350px"></a></p>
<h1 id="homebridge-air" class="tsd-anchor-link">Homebridge Air<a href="#homebridge-air" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h1>
<p><a href="https://www.npmjs.com/package/homebridge-air"><img title="npm version" src="https://badgen.net/npm/v/homebridge-air?icon=npm&label" ></a>
<a href="https://www.npmjs.com/package/homebridge-air"><img title="npm downloads" src="https://badgen.net/npm/dt/homebridge-air?label=downloads" ></a>
<a href="https://discord.gg/8fpZA4S"><img title="discord-air" src="https://badgen.net/discord/online-members/8fpZA4S?icon=discord&label=discord" ></a>
<a href="https://paypal.me/donavanbecker"><img title="donate" src="https://badgen.net/badge/donate/paypal/yellow" ></a></p>
<p>The Homebridge <a href="https://www.airnow.gov/">Air</a>
plugin allows you monitor the current AirQuality for your Zip Code from HomeKit and Siri.
</p>
</span>
<h2 id="installation" class="tsd-anchor-link">Installation<a href="#installation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<ol>
<li>Search for "Air" on the plugin screen of <a href="https://github.com/oznu/homebridge-config-ui-x">Homebridge Config UI X</a>.</li>
<li>Click <strong>Install</strong>.</li>
</ol>
<h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<ol>
<li>Login / create an account at <a href="https://www.airnow.gov/">https://www.airnow.gov/</a> or at <a href="https://aqicn.org/api/">https://aqicn.org/api/</a> as applicable for your location</li>
</ol>
<p align="center">
<img src="https://user-images.githubusercontent.com/9875439/133934622-05a9c19e-c5ba-46ee-b0db-0748420813d7.png" width="450px">
</p>
<ol start="2">
<li>
<p>Select your Provider: AirNow or Apicn</p>
</li>
<li>
<p>Enter your <a href="http://AirNow.gov">AirNow.gov</a> or Aqicn API Key</p>
</li>
<li>
<p>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</p>
</li>
<li>
<p>Optional Matter settings (Homebridge v2.0+):</p>
<ul>
<li><code>options.enableMatter: true</code> to explicitly request Matter. If Matter is unavailable or disabled, the plugin logs a warning and falls back to HAP.</li>
<li><code>options.preferMatter: true</code> to use Matter when available and enabled, but silently fall back to HAP otherwise.</li>
</ul>
</li>
<li>
<p>Migration behavior:</p>
<ul>
<li>Switching from HAP to Matter removes stale cached HAP accessories.</li>
<li>Switching from Matter to HAP removes stale cached Matter accessories.</li>
</ul>
</li>
<li>
<p>Click Save</p>
</li>
<li>
<p>Restart Homebridge</p>
</li>
</ol>
<h2 id="supported-air-quality-providers" class="tsd-anchor-link">Supported Air Quality Providers<a href="#supported-air-quality-providers" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<p>Currently supports AQI Services:</p>
<ul>
<li><a href="https://www.airnow.gov/">AirNow</a> which is limited to the USA. A valid ZipCode is required.</li>
<li><a href="https://www.aqicn.org/">Aqicn</a> which has international support, provided by the <a href="http://waqi.info/">World Air Quality Index Project</a>.</li>
</ul>
<p>Depending on where exactly you would like to monitor AQI, one service may be more appropriate than the other.</p>
<h2 id="supported-air-quality-features" class="tsd-anchor-link">Supported Air Quality Features<a href="#supported-air-quality-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<p>This 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, & O3 for AirNow. Aqicn adds NO2, SO2, CO...</p>
<h2 id="contributing" class="tsd-anchor-link">Contributing<a href="#contributing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<p>We welcome contributions! Please note our <strong>beta branch strategy</strong>:</p>
<ul>
<li><strong>All PRs must target a beta branch first</strong> (format: <code>beta-X.Y.Z</code>)</li>
<li><strong>Issues must have semantic versioning labels</strong> (<code>patch</code>, <code>minor</code>, <code>major</code>) before assignment</li>
<li><strong>Use our helper script</strong> to create beta branches: <code>./scripts/create-beta-branch.sh</code></li>
<li><strong>See our <a href="media/CONTRIBUTING.md">Contributing Guide</a></strong> for detailed instructions</li>
</ul>
<p>For GitHub Copilot users, please review our <a href="media/copilot-instructions.md">Copilot Instructions</a>.</p>
<h2 id="thanks" class="tsd-anchor-link">Thanks<a href="#thanks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
<p>Thank you to <a href="https://github.com/ToddGreenfield">ToddGreenfield</a> for the the work done on the accesorry based plugin <a href="https://github.com/ToddGreenfield/homebridge-airnow/blob/master/README.md">homebridge-airnow</a>.</p>
</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#homebridge-air"><span>Homebridge <wbr/>Air</span></a><ul><li><a href="#installation"><span>Installation</span></a></li><li><a href="#configuration"><span>Configuration</span></a></li><li><a href="#supported-air-quality-providers"><span>Supported <wbr/>Air <wbr/>Quality <wbr/>Providers</span></a></li><li><a href="#supported-air-quality-features"><span>Supported <wbr/>Air <wbr/>Quality <wbr/>Features</span></a></li><li><a href="#contributing"><span>Contributing</span></a></li><li><a href="#thanks"><span>Thanks</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="modules.html">@homebridge-plugins/homebridge-air</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer></footer><div class="overlay"></div></body></html>