blitzortung/README.md

Blitzortung Lightning Notifier

This project connects to the Blitzortung lightning detection network and sends notifications to your devices when lightning strikes are detected near your specified location.

Features

• Connects to Blitzortung's live WebSocket feed.
• Filters lightning strikes by your chosen location and radius.
• Sends rich notifications to your devices via ntfy.sh.
• Optionally displays details about the detectors involved in each strike.
• Supports multiple locales for notifications
• Gives you rough location of where the strike was using the nominatim api

Usage

Prerequisites

• Rust (edition 2021 or newer)
• ntfy.sh account or topic (no registration required)
• Optionally, a detectors.json file for detector details This file can be downloaded from my copyparty server, here.

Use

If you do not wish to compile blitzortung, feel free to download it from:

• Linux x64

Compile

cargo build --release

cargo run --release -- \
    --center-lat <latitude> \
    --center-lon <longitude> \
    --ntfy <ntfy_topic> \
    [--delta <radius>] \
    [--detector-fetch]

Detectors

If you enable --detector-fetch, make sure you have a valid detectors.json file in the project directory. This file should contain metadata about Blitzortung detectors.

License

MIT