Lightning detector
Strikes your detector hears show on Almighty's Lightning layer, at your station, labelled detected near this station, distance estimated.
1. Register in the Almighty app
There is no sign-up on this website. Open Almighty (the iPhone and iPad app, the Android app or the web app) and go to Settings → Contribute → Join Almighty Contribute. Sign in with Apple or with a code sent to your email (not as a guest), choose a display name and accept the contributor terms.
Then tap Add a station, choose Lightning detector, give it a name
and set its place on the map. The app shows the station's key, which starts
alm_st_. Copy it straight away: it is shown once only. If you
lose it, make a new key in the app (the old one stops working).
Everyone else sees your station's place rounded to about 1 km, never the exact spot. What it sends is shared under CC BY 4.0 and credited "Data © Almighty contributors (CC BY 4.0)".
2. Send each strike as JSON
A personal detector, such as one built on the AMS AS3935 chip, hears a strike's radio burst and estimates how far away the storm is (about 1 to 40 km); it can't tell the direction. So Almighty shows the strikes at your station with their estimated distance, never as a point where lightning struck. They sit alongside the Lightning layer's satellite data and don't replace it.
Send an HTTP POST with the key in the X-Station-Key header. The body
is one strike, or {"strikes": [...]} with up to 60. distance_km is
the detector's estimate (0 means overhead), energy is the chip's own unitless figure
(optional), and time is ISO 8601 or Unix seconds (left out: now).
curl -X POST http://api.almighty.live/v1/contribute/lightning \
-H "X-Station-Key: alm_st_…" \
-H "Content-Type: application/json" \
-d '{"time": "2026-10-20T15:42:10Z", "distance_km": 12, "energy": 184321}'
From a Raspberry Pi with an AS3935 board
Whatever library reads your board (for example a Python AS3935 driver), call something like this when it reports a strike. Don't send disturbers or noise events, only strikes.
import json, time, urllib.request
KEY = "alm_st_…" # your station key
def send_strike(distance_km, energy=None):
body = {"time": int(time.time()), "distance_km": distance_km}
if energy is not None:
body["energy"] = energy
req = urllib.request.Request(
"https://api.almighty.live/v1/contribute/lightning",
data=json.dumps(body).encode(),
headers={"Content-Type": "application/json", "X-Station-Key": KEY},
)
urllib.request.urlopen(req, timeout=10)
In a busy storm, collect strikes for a minute and send them together as
{"strikes": [...]}.
3. Checks on your strikes
- Distances must be between 0 and 60 km, and times within the last hour (and not ahead of now by more than two minutes).
- The map keeps each station's strikes for an hour, at most 50.
Limits
- Up to 60 strikes a minute per station are kept.
- Requests are small: at most 8 KB each.
- On a very busy day Almighty may stop taking new readings of this kind until midnight (UTC): your device gets an answer of 429 and can simply carry on; nothing is wrong with it.
- A station that sends nothing for two hours shows as offline in the app, and you can get a notification about it (Settings → Contribute → Notifications).
Help
Questions, or something not working? Email bonnyjames0@gmail.com with your station's name (never its key). See also Contribute to Almighty and Open data.