{"id":25120094,"url":"https://github.com/koho/airnose","last_synced_at":"2026-05-10T19:03:57.429Z","repository":{"id":276316469,"uuid":"928914418","full_name":"koho/AirNose","owner":"koho","description":"An air quality monitor built on ESP8266.","archived":false,"fork":false,"pushed_at":"2025-03-16T06:25:39.000Z","size":177,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T07:24:28.256Z","etag":null,"topics":["air-quality-monitor","esp8266","home-assistant"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-02-07T13:21:59.000Z","updated_at":"2025-03-16T06:25:42.000Z","dependencies_parsed_at":"2025-02-07T14:30:20.110Z","dependency_job_id":"8a64107e-75e0-41c6-95ee-dae5b2ea5db3","html_url":"https://github.com/koho/AirNose","commit_stats":null,"previous_names":["koho/airnose"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koho%2FAirNose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koho%2FAirNose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koho%2FAirNose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koho%2FAirNose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koho","download_url":"https://codeload.github.com/koho/AirNose/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246828477,"owners_count":20840474,"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":["air-quality-monitor","esp8266","home-assistant"],"created_at":"2025-02-08T05:19:12.067Z","updated_at":"2026-05-10T19:03:57.352Z","avatar_url":"https://github.com/koho.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Air Quality Monitor\r\n\r\nAir Nose is an air quality monitor built on ESP8266. It can be easily integrated\r\ninto [Home Assistant](https://www.home-assistant.io/) via MQTT protocol.\r\nIf you install it outdoors, you can also share your real-time air quality data on the [AQICN](https://waqi.info/) world\r\nmap.\r\n\r\n## Sensors\r\n\r\nIt currently supports PM, temperature, humidity and TVOC monitoring.\r\n\r\n### PMS5003 (Required)\r\n\r\nThe PMS5003 PM2.5 Air Quality Sensor is a high-performance sensor designed for accurate detection and measurement of\r\nparticulate matter (PM) in the air, specifically focusing on PM2.5 particles.\r\n\r\n- TX pin on sensor -\u003e D6\r\n- RX pin on sensor -\u003e D7\r\n\r\n### GY-SHT4x (Optional)\r\n\r\nSHT4x is a digital sensor platform for measuring relative humidity and temperature at different accuracy classes.\r\n\r\n- SDA pin on sensor -\u003e D1\r\n- SCL pin on sensor -\u003e D2\r\n\r\nEnable it by defining `USE_TEMP`.\r\n\r\n### GY-SGP30 (Optional)\r\n\r\nThe SGP30 is a digital multi-pixel VOC sensor.\r\n\r\n- SDA pin on sensor -\u003e D1\r\n- SCL pin on sensor -\u003e D2\r\n\r\nEnable it by defining `USE_TVOC`.\r\n\r\n## Configuration\r\n\r\nThe config file is located in `include/config.h`. You must check your config file before uploading your program.\r\n\r\n| Name           | Type   | Required  | Description                                 |\r\n|----------------|--------|-----------|---------------------------------------------|\r\n| USE_TEMP       |        | No        | Enable the humidity and temperature sensor. |\r\n| USE_TVOC       |        | No        | Enable the VOC sensor.                      |\r\n| LAT            | float  | Yes       | Latitude.                                   |\r\n| LNG            | float  | Yes       | Longitude.                                  |\r\n| STASSID        | string | Yes       | WiFi SSID.                                  |\r\n| STAPSK         | string | Yes       | WiFi password.                              |\r\n| MQTT_ADDR      | string | Yes       | MQTT server address.                        |\r\n| MQTT_PORT      | int    | Yes       | MQTT server port.                           |\r\n| MQTT_USERNAME  | string | No        | MQTT username.                              |\r\n| MQTT_PASSWORD  | string | No        | MQTT password.                              |\r\n| USE_AQICN      |        | No        | Publish data to AQICN.                      |\r\n| AQICN_ID       | string | USE_AQICN | Station ID.                                 |\r\n| AQICN_NAME     | string | USE_AQICN | Station name.                               |\r\n| AQICN_TOKEN    | string | USE_AQICN | Token from AQICN.                           |\r\n| AQICN_INTERVAL | int    | USE_AQICN | Data push interval (minutes).               |\r\n\r\n## Screenshots\r\n\r\n![homeassistant](/docs/ha.png)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoho%2Fairnose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoho%2Fairnose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoho%2Fairnose/lists"}