Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Sponsor GitHub release GitHub Actions License

Airqmon icon Airqmon

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.

Airqmon window with measurement details

Airqmon notification about air quality

Supported data providers

  • Airly - over 20k sensor stations in many cities around the world in addition to data provided from third-party services like PurpleAir. Check the Airly map for full coverage.

Disclaimer: Airqmon API is using my own personal Airly API key, which falls under the general Airly free usage rate limits. When inquired about increasing the limits to sustain the rising number of Airqmon's users, Airly asked me in return to sign a legally binding contract. Due to the nature of this project, I am unable to comply with this demand. As a result, Airqmon will stop displaying air quality data at a certain user threshold, or the displayed data will be outdated.

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.


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, Airmoqn uses the Airmon API, a companion service, to find the nearest station and fetch measurements.


macOS doesn't allow me to start the app

Since macOS Sierra, if you try to open an app that is not registered with Apple by an identified developer you get a warning dialog. Airqmon is not signed nor was submitted to Apple for review.

Screenshot 2021-03-02 at 10 02 17

To override your security settings and open the app:

  1. In the Finder, locate the app you want to open.
  2. Control-click the app icon, then choose Open from the shortcut menu.

Read more: PH25088


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


This project is supported by:


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

Michał Pierzchała Konrad Dzwinel
Michał Pierzchała Konrad Dzwinel


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