Skip to content

A sensor that gives you weather alerts from alerts.weather.gov.

License

Notifications You must be signed in to change notification settings

custom-components/weatheralerts

Repository files navigation

An integration to get weather alerts from weather.gov

GitHub release (latest by date) GitHub hacs_badge

GitHub stars GitHub GitHub issues GitHub commits since latest release (by SemVer)

Breaking changes

v0.1.2

  • The YAML packages currently available for weatheralerts v0.1.2 are not compatible with prior versions of weatheralerts. Older YAML packages should still work with weatheralerts v0.1.2, however, the most recent YAML package files contain new features and fixes.

Installation Quickstart

This qickstart install guide assumes you are already familiar with custom component installation and with the Home Assistant YAML configuration. If you need more detailed step-by-step instructions, check the links at the bottom for detailed instructions. Troubleshooting information, weatheralerts YAML package information, and Lovelace UI examples are also included in the Links at the bottom.

Install the weatheralerts integration via HACS. After installing via HACS, don't restart Home Assistant yet. We will do that after completing the YAML platform configuration.

You will need to find your zone and county codes by looking for your state or marine zone at https://alerts.weather.gov/. Once at https://alerts.weather.gov/, click the Land area with zones link and you will find a list of states with Public Zones and County Zones links. Once you find your state , click into the Public Zones and County Zones links and find the respective codes for your county. All you will need are just the first two letters (your state abbreviation) and the last three digits (zone/county ID number) of your zone code and county code to put into the platform configuration. The zone and county ID numbers are not usually the same number, so be sure to look up both codes. For marine zones, go to https://alerts.weather.gov/, click the Marine regions/areas with zones link and you will find a list of marine areas with Zones links. In the Zones link for the marine area you are interested in, find the exact marine zone. The first two letters of the marine zone is what will be used for the state configuration option, and the last three digits is what will be used for the zone configuration option (omit any leading zeros).

Once installed and you have your state (or marine zone) abbreviation and ID numbers, add the weatheralerts sensor platform to your configuration. If your state is Wisconsin and your county is Outagamie, then the state abbreviation is WI, the zone ID number is 038, and the county ID number is 087. For the ID numbers, remove any leading zeros and your YAML platform configuration would look something like this:

sensor:
  platform: weatheralerts
  state: WI
  zone: 38
  county: 87

Once your configuration is saved, restart Home Assistant.

That completes the integration (custom component) installation.

Check the Links below for more detailed instructions, troubleshooting, and for YAML package and Lovelace UI usage and examples.

Updating via HACS

Check the Breaking Changes section of this README to see if you need to manually update the YAML packages or make any changes to your custom YAML or Lovelace UI cards. Simply use the Update button for the weatheralerts integration within HACS if there are no breaking changes and then restart Home Assistant.

Links

Todo list

  • Add more documentation
  • Add config flow to allow UI-based configuration (eliminate yaml-based platform configuration)
  • Create alternative (possibly simpler) YAML package or move some template sensors into the integration
  • Add backup weather alert source for occasions when weather.gov json feed is experiencing an outage
  • Add Canadian weather alerts