Home

Awesome

Sponsor GitHub release GitHub Actions License

<img src="https://user-images.githubusercontent.com/1029142/32918679-7336704a-cb23-11e7-92b2-d8a7f2588055.png" width="38px" alt="Airqmon icon" align="top" /> Airqmon

Airqmon is a macOS menu bar application that displays live air quality data from the nearest sensor station. It can also notify you when the air quality index changes or when a new, closer station is found.

<p align="center"> <img width="492" align="center" alt="Airqmon window with measurement details" src="https://github.com/jsynowiec/airqmon/raw/gh-pages/assets/airqmon-overview%402x.png" /> </p> <p align="center"> <img src="https://user-images.githubusercontent.com/1029142/36537429-674931ba-17d0-11e8-88ee-c246226c1053.png" width="378px" align="center" alt="Airqmon notification about air quality" /> </p>

Supported data providers

Source code-only

Due to the reasons described in this comment, I am no longer willing to cover the monthly costs associated with the Airqmon API and Google Geolocation.

I have removed all binaries from the current and previous releases as they will no longer work. You can host the Airqmon API on your own and clone the latest release to build your version of the app.

Build & installation

  1. Clone the latest release.
  2. Install the dependancies with yarn install.
  3. Build the binary with yarn run package.
  4. Drag the binary from the out directory to your Applications folder.

Preferences

There are a few options available to customize on the preferences window that you can access by clicking on the button with a cog or by pressing the ⌘ + , shortcut.

Airqmon API

From version 2, Airqmon uses the Airmon API, a supplementary service, to find the nearest station and fetch measurements.

Geolocation

From version 2.1.1, Airqmon uses the free ip-api.com for geolocation. If you want to switch back to the Google Geolocation API, revert the relevant changes from the 1fe51d commit.

Privacy

Airqmon application does not track any personally identifiable information or usage analytics.

Credits

My sincere thanks to the following individuals for helping me with beta testing and for donating 🙏

MichaƂ PierzchaƂaKonrad Dzwinel
MichaƂ PierzchaƂaKonrad Dzwinel

License

This app is an open-source software licensed under the Apache License, Version 2.0