Home
Softono
homeassistant-blitzortung

homeassistant-blitzortung

Open source MIT Python
307
Stars
52
Forks
10
Issues
16
Watchers
1 week
Last Commit

About homeassistant-blitzortung

Custom Component for fetching lightning data from blitzortung.org

Platforms

Web Self-hosted

Languages

Python

Links

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

Dashboard Card

You can use the Weather Radar Card to show real time lightning strikes.

https://github.com/user-attachments/assets/61980296-1bfb-4279-878d-96a6cba575a0

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