Skip to main content
Version: 2.7

Air Quality & Fog

Display air quality index (AQI) and fog/visibility conditions on your board using PurpleAir and OpenWeatherMap data.

Air Quality and Fog on split-flap board

Overview

The Air Quality & Fog plugin provides:

  • Current AQI with color-coded status
  • Fog and visibility conditions
  • Configurable location via coordinates

Setup

1. Get API Keys

PurpleAir (for AQI):

  1. Sign up at purpleair.com
  2. Request an API key from the PurpleAir data page

OpenWeatherMap (for visibility/fog):

  1. Sign up at openweathermap.org
  2. Free tier: 1,000 calls/day

2. Enable in the Web UI

  1. Open http://localhost:4420
  2. Go to the Integrations page
  3. Toggle Air Quality & Fog on
  4. Enter your API keys and set your location coordinates
  5. Click Save Changes

Available Variables

VariableDescriptionExample
{air_fog.aqi}Air Quality Index value42
{air_fog.air_status}Air quality status textGOOD
{air_fog.air_color}Color indicator for AQI{66}
{air_fog.fog_status}Fog/visibility statusLIGHT FOG
{air_fog.visibility}Visibility distance8.5 MILES
{air_fog.formatted}Formatted display stringAQI 42 GOOD

Next Steps