Skip to content

Commit b74f8cb

Browse files
committed
feat(air-quality): bump version to 1.1.0 and update README
Document dual data source support: Open-Meteo (forecasting) vs AQICN (real monitoring station data).
1 parent 7636660 commit b74f8cb

2 files changed

Lines changed: 16 additions & 8 deletions

File tree

air-quality/README.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,18 @@
11
# Air Quality
22

3-
Displays real-time air quality data from the Open-Meteo API with EPA color coding.
3+
Displays real-time air quality data with EPA color coding.
44
Shows AQI index (US EPA or European scale) and pollutant breakdown for PM2.5, PM10, O3, NO2, CO, and SO2.
55

6+
## Data Sources
7+
8+
| Source | Type | API Key | AQI Scales |
9+
|--------|------|---------|------------|
10+
| **Open-Meteo** (default) | Forecasting (CAMS atmospheric models) | Not required | US EPA, European |
11+
| **AQICN** | Real monitoring station data | Free token required | US EPA only |
12+
13+
- **Open-Meteo** uses Copernicus CAMS atmospheric models at 11-40km resolution. No API key needed, but values are forecasted estimates.
14+
- **AQICN** provides real-time data from the nearest EPA monitoring station. Requires a free API token from [aqicn.org/data-platform/token](https://aqicn.org/data-platform/token). Shows the station name in the location pill.
15+
616
## Features
717

818
**Bar Widget**
@@ -14,7 +24,7 @@ Shows AQI index (US EPA or European scale) and pollutant breakdown for PM2.5, PM
1424

1525
**Panel**
1626
- Large AQI number with level indicator
17-
- Location pill with last update time
27+
- Location pill with last update time (shows station name when using AQICN)
1828
- Pollutant rows with colored indicators
1929
- Refresh and settings buttons
2030

@@ -25,15 +35,13 @@ Shows AQI index (US EPA or European scale) and pollutant breakdown for PM2.5, PM
2535
- Middle click to refresh
2636

2737
**Settings**
28-
- AQI scale: US AQI (EPA) or European AQI
38+
- Data source: Open-Meteo (forecasting) or AQICN (real station data)
39+
- AQICN API token field (visible when AQICN selected)
40+
- AQI scale: US AQI (EPA) or European AQI (disabled when using AQICN)
2941
- Location: use Noctalia location or custom coordinates
3042
- Refresh interval (5-120 minutes)
3143
- Bold text toggle
3244

3345
**IPC**
3446
- Refresh: `qs -c noctalia-shell ipc call plugin:air-quality refresh`
3547
- Toggle panel: `qs -c noctalia-shell ipc call plugin:air-quality toggle`
36-
37-
## Data Source
38-
39-
[Open-Meteo Air Quality API](https://open-meteo.com/)

air-quality/manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"id": "air-quality",
33
"name": "Air Quality",
4-
"version": "1.0.0",
4+
"version": "1.1.0",
55
"minNoctaliaVersion": "3.6.0",
66
"author": "adriamartin91",
77
"license": "MIT",

0 commit comments

Comments
 (0)