Almighty

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

Limits

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.