Air quality, one glance away.

A live AQI in your macOS menu bar or Windows system tray. Free, open source, and it talks straight to aqicn.org with your own token — no account, no server of ours.

macOS 11+ (Apple Silicon and Intel) · Windows 10/11 · MIT licence

The AQI Menubar panel: 82 AQI, moderate, Shanghai station, pollutants and data sources

What it does

A menu bar you actually control

Show the AQI, the PM2.5 number, or just a colour dot. Add “AQI 51”, the quality level (“51 · Moderate”, “51 · 良”), the station name, or none of them. The panel previews the result as you toggle it, and the text can take the level colour.

English, 简体中文, 日本語

Follows your system language, or pick one in Settings. The tray menu changes with it.

Your token, your request

Each reading is fetched from your machine to aqicn.org with the free token you register in ten seconds. Nothing passes through a server of ours, and there is no telemetry.

Honest when it can't refresh

A failed refresh keeps the last reading and marks it stale, instead of turning into a blank panel at the moment you care.

Updates itself

Signed updates from GitHub Releases install in place and restart the app. No update server, no account.

MIT, all of it

Rust and TypeScript, built with Tauri. Read it, fork it, ship your own version.

Install

Build from source

Rust + pnpm, a couple of minutes

git clone https://github.com/z-hhh/aqi-menubar.git Open the repository

macOS

Universal .dmg for macOS 11 and later

Open the releases page

Windows

Installer for Windows 10 and 11

Open the releases page

After installing: open the app, press “Get a free token”, paste the token that arrives by email. That's it.

Data, and who made it

Readings come from the World Air Quality Index project (aqicn.org / waqi.info) and the monitoring agencies that contribute to it. The panel shows the attribution the API returns for every reading — the agency that measured it — as a link, as the platform's terms require.

The app is free and is not affiliated with or endorsed by WAQI. It does not sell, resell, cache or redistribute the data: each client fetches its own readings with its own token.

  1. Install the app.
  2. Get a free token at aqicn.org — email only.
  3. Paste it in Settings and pick your city.