{
  "packageName": "Air Quality Window Alerts",
  "author": "RamSet",
  "version": "1.11.0",
  "releaseNotes": "1.11.0 - Fixed repeated alerts for the same air quality change. An outdoor sensor sitting close to your alert threshold drifts back and forth across it, and every dip below the line used to count as the air having recovered — so the next reading back above it was treated as a brand new event and you were told again, sometimes several times a minute. Recovery now has to be convincing: the air must fall a set number of AQI points below your threshold AND stay there for a set number of minutes before the app will alert about that band again. Both are adjustable under \"When is the air 'bad'?\" and default to 10 points and 15 minutes. The app page shows a recovery countdown while it is in progress. Notifies you when windows or doors are open while the outdoor air quality is bad. Two independent alerts: one fires when you open a window into bad air, the other fires when the air outside turns bad, or gets worse, while something is already open. The cooldown now applies only to windows being opened, so once you have been told, opening more windows will not nag you for a set number of minutes. Air quality actually getting worse while a window is open always reaches you straight away, and repeats only when the air moves into a worse band. Every alert message is editable, with sensible defaults and tokens for the open sensors and the outdoor and indoor readings. Alerts are held while the extractor fan is drawing power, since it is already exhausting cooking fumes, and the app re-checks once the fan stops. The app page now opens with a live panel: outdoor and indoor air quality with the index, particle level, temperature and humidity, whether the air currently counts as bad, whether the exhaust fan is running, when the last alert went out, and every window and door listed as open or closed. Air quality sensors can now be selected in groups rather than one at a time, and the app judges on the worst reading across them, which is how an overall air quality index is properly computed. This matters because a sensor's own index often reflects only one pollutant, so a clean particle reading could previously hide a bad chemical one. Messages and the app page now name which sensor is driving the verdict. Alerts can now be spoken aloud on your speakers as well as, or instead of, being sent as notifications, with an optional volume for the announcement. Quiet hours can be set so the speakers stay silent overnight while push notifications still reach your phone, or optionally hold those too. Alerts now say in plain English what the air quality means for you — 'keep the windows shut' rather than just a number — alongside the readings, via a new %outdoorAdvice% token in the message. Alerts now fire only once per air quality category: you are told when the air first becomes bad and again only when it worsens into a higher category, not repeatedly within the same one. Closing and reopening a window no longer re-triggers the same alert — only the air recovering, then going bad again, does.",
  "category": "Air Quality",
  "tags": "Air Quality, PM2.5, Contact Sensor, Notification, Windows, AQI",
  "dateReleased": "2026-08-13",
  "minimumHEVersion": "2.3.0",
  "apps": [
    {
      "id": "fbd3184c-87a6-45df-99f1-832406294971",
      "name": "Air Quality Window Alerts",
      "namespace": "ramset",
      "location": "https://raw.githubusercontent.com/RamSet/hubitat/refs/heads/main/apps/air-quality-window-alerts/air-quality-window-alerts.groovy",
      "required": true,
      "oauth": false,
      "primary": true,
      "description": "Notifies when windows/doors are open and outdoor air quality is bad, with exhaust-fan suppression while cooking."
    }
  ]
}