Show air quality in your Mac menu bar

Wildfire smoke, pollen season, a bad traffic day. The air quality index tells you whether to open the window or go for that run, and with alert levels set it tells you when it changes.

Recipe tested October 29, 2026 with Multimeter 1.1. Source: Web Address.

Preview: the Gradient Track face and two alternatives, with sample values like the ones this recipe returns.

What you need

  • Multimeter for macOS 13 or later, $19.99 once.
  • Your latitude and longitude.

Set it up

  1. Find your latitude and longitude. Open-Meteo’s place search gives them for any town (the first result’s latitude and longitude):
    Terminal
    curl -s 'https://geocoding-api.open-meteo.com/v1/search?name=Plano&count=1'
  2. Add a Web Address meter with this address and the key path current.us_aqi:
    Web address
    https://air-quality-api.open-meteo.com/v1/air-quality?latitude=33.02&longitude=-96.70&current=us_aqi
  3. Refresh every 15 minutes. Range 0 to 200; alerts on High values at 100 (unhealthy for sensitive groups) and 150 (unhealthy).

Multimeter settings

In Customize This Meter… (from the meter’s menu):

Settings for this meter
SettingValue
SourceWeb Address
Web addresshttps://air-quality-api.open-meteo.com/v1/air-quality?latitude=LAT&longitude=LON&current=us_aqi
Key pathcurrent.us_aqi
Refresh every15 minutes
Range0 to 200
AlertsHigh values: warning 100, critical 150
LabelAQI
FaceGradient Track, Mood or Plant

Tested: Run on October 29, 2026 for Plano, Texas: US AQI 53, PM2.5 7.9 µg/m³; Berlin: European AQI 50.

More on this source, including every format it reads, in the Web Address guide.

Limits

  • Open-Meteo allows up to 10,000 calls a day for non-commercial use without a key; one meter every 15 minutes uses 96. Its models update about every hour.
  • These are modeled values for your coordinates, not a sensor on your street.

Variations

European AQI

Use current=european_aqi and the key path current.european_aqi. Alerts at 60 and 80.

PM2.5 in µg/m³

current=pm2_5, key path current.pm2_5. The WHO daily guideline is 15.

Pollen (Europe)

current=grass_pollen (or birch_pollen, ragweed_pollen), grains per m³. Open-Meteo’s pollen data covers Europe only.

Troubleshooting

What the meter says, why, and what to do
SymptomCauseFix
No number found in the responseThe key path doesn’t match the reply.Run curl -s with the address and read the JSON. Dots walk into objects, numbers pick array items (items.0.count).
Couldn’t reach the addressNo network, a typo in the host, or the service is down.Open the address in your browser. Multimeter tries again at the next refresh.

Questions

What do the AQI numbers mean?

US AQI: 0 to 50 good, 51 to 100 moderate, 101 to 150 unhealthy for sensitive groups, 151 to 200 unhealthy, above 200 very unhealthy.

Related

Put it in your menu bar

$19.99 one-time. No subscription. Needs macOS 13 Ventura or later.