A macOS app that runs on the menu bar and shows air quality from your uHoo device.
$ # clone and install airq
$ git clone git@github.com:jererobles/airq.git && cd airq
$ poetry install
$ # create .env with userId + password
$ cp .env.example .env
$ nano .env
$ # run the venv
$ poetry run python airq/__main__.pyAirQ will create a session file in the app directory to keep refresh tokens and avoid unnecessary requests to the uHoo API.
$ poetry run python setup.py py2app| Emoji | Caused by | Comments |
|---|---|---|
| – | All OK | |
| 🤢 | Carbon dioxide | Open the windows |
| 🌵 | Low humidity | Turn on humidifier |
| 💦 | High humidity | Turn on AC |
| 😷 | Dust | Do some cleaning |
| 😣 | Negative air pressure | Open a window |
| 😖 | Positive air pressure | Turn off ventilation |
| 🫁 | Red-brown gases | Get some fresh air |
| 😵 | Various factors | Air is bad |
| ☠️ | Carbon monoxide | Air is poisonous |
| 🦠 | Various factors | "Virus Index" triggered |
| ❌ | App error | Connectivity issues or API changes |
- create initial login script by reversing authentication
- create class to interface with API
- use sessions to avoid handling cookies manually
- persist session after script terminates
- do something with data
- make binaries
- show values in menu bar