Air Quality Card — Home Assistant card
Air quality in Home Assistant: ATMO index, PM2.5 and PM10 particles (SDS011 or another sensor), up to six pollutants and health advice.
Available on request. This card is not published on HACS, but you can get it: write to me to ask for it. Request this card
Overview
Air Quality Card shows air quality in Home Assistant using the French ATMO index, computed from PM2.5 and PM10 particle sensors such as the SDS011.
It can track up to six pollutants (PM2.5, PM10, NO₂, O₃, SO₂, CO), shows which one sets the index and gives health recommendations. A sparkline shows the last 6 to 48 hours with a trend arrow; the card comes in detailed or compact mode, in French and English.
Features
- French ATMO index (1 to 6) computed automatically, with a color gradient following air quality
- Up to 6 pollutants: PM2.5, PM10, NO₂, O₃, SO₂ and CO
- Dominant pollutant: the one that sets the index
- Health recommendations based on air quality
- History sparkline (6 to 48 h) and trend indicator (↗ ↘ →)
- Time of the last update
- Detailed or compact mode, light, dark or automatic theme
- Animated decorative bubbles
- French and English, language detected automatically
- Screen-reader friendly (ARIA)
Configuration
type: 'custom:air-quality-card'
entity_pm25: sensor.particule_2_5mm_concentration
entity_pm10: sensor.particule_10_0mm_concentration
Options
| Option | Type | Default | Description |
|---|---|---|---|
type (required) | string | custom:air-quality-card | |
entity_pm25 | string | PM2.5 sensor entity | |
entity_pm10 | string | PM10 sensor entity | |
title | string | "Qualité de l'Air" | Card title |
show_sparkline | boolean | true | Show the history mini chart |
show_trend_indicator | boolean | true | Show the trend indicator (→) |
show_last_update | boolean | true | Show "X min ago" |
mode | string | 'detailed' | Display mode: 'detailed' or 'compact' |
history_hours | number | 24 | Hours of history for the chart: 6, 12, 24, 48 |
theme | string | 'auto' | Theme: 'auto', 'light' or 'dark' |
entity_no2 | string | NO₂ (nitrogen dioxide) sensor entity | |
entity_o3 | string | O₃ (ozone) sensor entity | |
entity_so2 | string | SO₂ (sulfur dioxide) sensor entity | |
entity_co | string | CO (carbon monoxide) sensor entity | |
show_all_pollutants | boolean | true | Show all pollutants or only the top 4 |
show_dominant_pollutant | boolean | true | Show which pollutant sets the index |
show_recommendations | boolean | false | Show health recommendations |
language | string | 'auto' | Language: 'auto', 'fr', 'en' |