Air/Story

Air Story in Home Assistant.

Sensors for today's air, and automations that react when it changes: tint a lamp for a Santa Ana, get a ping when fog rolls in. One poll every 15 minutes; everything else stays on your network.

What your devices will say right now

Pick a spot above, or tap below.

The integration

Download the integrationcustom_components/airstory · sensors, an alert sensor and an event when the air changes↓
  1. Unzip it into your Home Assistant config/ folder. You get custom_components/airstory/ and the two automation blueprints.
  2. Restart Home Assistant.
  3. Settings → Devices & services → Add integration → Air Story. It starts at your home location; nothing to sign up for.

Automations

No custom integration? Use the YAML package

Drop this file into config/packages/ (with packages: !include_dir_named packages under homeassistant:) and restart. It builds the same sensors with the built-in REST integration.

Download airstory.yamlREST sensors from your home zone, 15-minute updates↓
What you get
  • sensor.air_story: the weather word (Muggy, Marine layer, Santa Ana winds…) with the headline, color, spoken line and link as attributes
  • Temperature, dew point, humidity, where the air came from and how far
  • binary_sensor for active weather alerts
  • An airstory_event_changed event for your own automations

Covers the United States for now. The spoken answer uses National Weather Service stations; the rest of the world is next.

Privacy

Your spot is rounded to about 7 miles before it's used, and nothing about you is stored. Devices ask our server at most every 15 minutes; it answers from public NOAA and National Weather Service data. No account, no key, no sign-up.

See your air right nowThe full story in your browser. No sign-up.→