Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jsynowiec/airqmon
A macOS menu bar application that displays live air quality data from the nearest sensor station.
https://github.com/jsynowiec/airqmon
air-pollution air-quality air-quality-monitor airly electron graphql macos macos-menubar poland react sensor-station smog typescript
Last synced: 12 days ago
JSON representation
A macOS menu bar application that displays live air quality data from the nearest sensor station.
- Host: GitHub
- URL: https://github.com/jsynowiec/airqmon
- Owner: jsynowiec
- License: apache-2.0
- Created: 2017-11-16T12:34:38.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2023-03-20T07:51:12.000Z (over 1 year ago)
- Last Synced: 2024-05-22T13:14:54.540Z (6 months ago)
- Topics: air-pollution, air-quality, air-quality-monitor, airly, electron, graphql, macos, macos-menubar, poland, react, sensor-station, smog, typescript
- Language: TypeScript
- Homepage: https://jsynowiec.github.io/airqmon/
- Size: 2.71 MB
- Stars: 98
- Watchers: 4
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- open-sustainable-technology - airqmon - A macOS menu bar application that displays live air quality data from the nearest sensor station. (Natural Resources / Air Quality)
README
[![Sponsor][sponsor-badge]][sponsor]
[![GitHub release][badge-github-release]][airqmon-latest-release]
[![GitHub Actions][badge-gh-actions]][gh-actions]
[![License][badge-license]][license]
# 
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.
## Supported data providers
- [Airly][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][airly-map] for full coverage.
## Source code-only
Due to the reasons described in [this comment](https://github.com/jsynowiec/airqmon/issues/50#issuecomment-1008751034), 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][airqmon-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][airqmon-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](https://github.com/jsynowiec/airqmon/commit/1fe51d966f15caeeca1e6385d01b96c6e266210c) 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 🙏
| [](https://github.com/thymikee) | [](https://github.com/kdzwinel) |
| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [Michał Pierzchała](https://github.com/thymikee) | [Konrad Dzwinel](https://github.com/kdzwinel) |
## License
This app is an open-source software licensed under the [Apache License, Version 2.0][license]
[license]: https://raw.githubusercontent.com/jsynowiec/airqmon/main/LICENSE
[airqmon-latest-release]: https://github.com/jsynowiec/airqmon/releases/latest
[airqmon-api]: https://github.com/jsynowiec/airqmon-api
[gh-actions]: https://actions-badge.atrox.dev/jsynowiec/airqmon/goto?ref=main
[badge-github-release]: https://img.shields.io/github/release/jsynowiec/airqmon.svg
[badge-license]: https://img.shields.io/github/license/jsynowiec/airqmon.svg
[badge-gh-actions]: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fjsynowiec%2Fairqmon%2Fbadge%3Fref%3Dmain&style=flat
[airly]: https://airly.eu/
[airly-map]: https://airly.org/map/en/
[airly-pricing]: https://airly.org/en/pricing/airly-api/
[sponsor-badge]: https://img.shields.io/badge/♥-Sponsor-fc0fb5.svg
[sponsor]: https://github.com/sponsors/jsynowiec