aaronmayeux/ha-hurricane-tracker

Hurricane Tracker is a Home Assistant integration that adds a live tropical cyclone map card to your smart home dashboard. It draws the official forecast cone of uncertainty, past and predicted storm tracks, intensity category markers, coastal watch and warning segments, and a data bar showing distance from your home, current storm intensity, movement speed, and forecast peak. Coverage is worldwide: it pulls Atlantic and Pacific data from the US National Hurricane Center and global basin data from the EU's Global Disaster Alert system for every other ocean basin. The map is built from a bundled offline basemap derived from publicly available coastline data. No external map tile service is needed, so the card has no API keys and no external dependencies beyond the integration itself. The Python integration uses only the Python standard library. Installation goes through HACS, the Home Assistant Community Store, by adding this repository as a custom repository source. After downloading and restarting Home Assistant, you add the integration through the normal Settings menu. Setup asks for your home location, which basins or distance radius to watch, whether to show miles or kilometers, and what to display during the off-season when no storms are active. Adding the card to a dashboard is a one-line YAML entry. The card automatically loads its own JavaScript without needing a manual dashboard resource step. It reads your Home Assistant theme colors by default, so the map background, land, coastlines, and text match your dashboard in both light and dark mode without any configuration. The only colors that do not follow the theme are the Saffir-Simpson category dots and the official watch and warning segment colors, which are fixed to preserve their emergency communication meaning. You can override any of the visual options with YAML or using the card's built-in visual editor. Layer toggles let you turn off individual map elements like state borders, region labels, or the home marker. The integration cycles through multiple active storms if you set it to show all storms, or pins to the one closest to or most threatening to your home location.