Skip to content

mrk-its/homeassistant-blitzortung

Repository files navigation

Blitzortung.org lightning detector

hacs_badge

Buy Me A Coffee

Blitzortung.org is a worldwide, real time, community collaborative lightning location network. This component uses Blitzortung data and provides real time notifications about lightning strikes in a given area (by default within 100km radius of your home). Data is served through a public MQTT server (dedicated to serve requests for this component) - thanks to geohash-based topics and some other optimizations, it greatly reduces amount of data sent to clients comparing to direct websocket connection to Blitzortung servers (it is also required by Blitzortung data usage policy - third party apps must use their own servers to server data for their own clients).

Features

  • distance and azimuth sensors of lightning strikes nearby
  • counter of lightning strikes
  • emits geo_location events for lightning strikes (visible on the map)
  • data is realtime, with average delay of few seconds

Manual installation

Place custom_components/blitzortung directory inside custom_components dir and restart Home Assistant

HACS installation

This component is available on HACS default

Configuration

To configure the integration go to Settings >> Devices & services >> Add integration and search for Blitzortung. During configuration there are two ways of providing the location:

  • By providing latitude and longitude. Blitzortung integration defaults to the home location of your Home Assistant instance but you can override that.
  • By providing a location entity (device_tracker, person or zone). Blitzortung integration will then follow the coordinates provided by the selected entity.

You can change the coordinates for an existing Blitzortung configuration using the reconfigure flow, go to Settings >> Devices & services >> Blitzortung >> 3 dot menu >> Reconfigure.

To change the detection radius, time window, and max tracked lightnings, go to Settings >> Devices & services >> Blitzortung >> Configure.

Important

If you use a location entity as the coordinate source, the integration will use new coordinates if the location changes by more than 25% of the radius length.

Reviews and How-Tos

You can read and see (YouTube) how this component was used in the following community video. How to Add a Lightning Sensor

How to create dev environment

git clone https://github.com/mrk-its/homeassistant-blitzortung.git
cd homeassistant-blitzortung
python3.13 -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt
prek install

About

Custom Component for fetching lightning data from blitzortung.org

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors