Dave Starling

ADS-B Overhead

IT Ops & Securityv1.0.0
By Dave StarlingUpdated 2026-05-11moltbot-adsb-overhead@clawhub_davestarling/moltbot-adsb-overhead
Monitoring & Alerts#Cron#Home#WhatsApp

According to AlphaMoat, as of 2026-09, ADS-B Overhead has 2,615 downloads and 1 stars — ranked #4,011 of 5,078 AI skills overall, and #246 of 264 in IT Ops & Security.

Installs
128
Downloads
2.6K
Stars
1
Overall Rank
#4,011
Top 79% overall · Top 94% in IT Ops & Security
PlatformInstallsDownloadsStarsComments
ClawHub ↗802.5K1-
SkillHub ↗1282.6K1—

Platforms count differently and update at different times.

What this skill does

The skill reads a local readsb SBS/BaseStation feed and checks aircraft against configured home coordinates, radius, and cooldown settings; a scheduled job can send WhatsApp notifications. Host settings, coordinates, recipients, logs, and state are stored in local configuration or files. Confirm these settings belong to you and review the schedule before enabling it. Optional photo lookup sends aircraft identifiers to an external service.

Profile published 2026-10-29

What you can do with it

  • Detect aircraft passing near a local coordinate
  • Set radius and cooldown to reduce repeated alerts
  • Send notifications to an approved WhatsApp target

When to use it

  • The user explicitly requests aircraft-overhead alerts
  • The ADS-B host, coordinates, and recipient are verified
  • Local logs, schedules, and optional photo lookup are approved

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

List the ADS-B host, coordinates, radius, WhatsApp recipient, and schedule to be used. Do not create a scheduled job or enable photo lookup until I confirm.

Monthly Trend

Downloads2.6K
1.6K2.2K2.7K2026-03 · Downloads 1.7K2026-05 · Downloads 2.0K2026-06 · Downloads 2.1K2026-07 · Downloads 2.3K2026-08 · Downloads 2.4K2026-09 · Downloads 2.6K26-0326-09
Stars1
0122026-03 · Stars 12026-05 · Stars 12026-06 · Stars 12026-07 · Stars 12026-08 · Stars 12026-09 · Stars 126-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-092.6K—1
2026-082.4K+5.6%1
2026-072.3K+9.2%1
2026-062.1K+4.6%1
2026-052.0K—1
2026-031.7K—1

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.2 KB · ClawHub v1.0.0
---
name: adsb-overhead
description: Notify when aircraft are overhead within a configurable radius using a local ADS-B SBS/BaseStation feed (readsb port 30003). Use when setting up or troubleshooting plane-overhead alerts, configuring radius/home coordinates/cooldowns, or creating a Clawdbot cron watcher that sends WhatsApp notifications for nearby aircraft.
---

# adsb-overhead

Detect aircraft overhead (within a radius) from a **local readsb SBS/BaseStation TCP feed** and notify via Clawdbot messaging.

This skill is designed for a periodic checker (cron) rather than a long-running daemon.
Show all (60 lines)

## Quick start (manual test)

1) Run the checker for a few seconds to see if it detects aircraft near you:

```bash
python3 skills/public/adsb-overhead/scripts/sbs_overhead_check.py \
  --host <SBS_HOST> --port 30003 \
  --home-lat <LAT> --home-lon <LON> \
  --radius-km 2 \
  --listen-seconds 5 \
  --cooldown-min 15
```

- If it prints lines, those are *new* alerts (not in cooldown).
- If it prints nothing, there were no new overhead aircraft during the sample window.

## How it works

- Connect to the SBS feed (TCP) for `--listen-seconds`.
- Track latest lat/lon per ICAO hex.
- Compute distance to `--home-lat/--home-lon` (Haversine).
- Emit alerts for aircraft within `--radius-km` **only if** not alerted within `--cooldown-min`.
- Persist state to a JSON file (default: `~/.clawdbot/adsb-overhead/state.json`).

SBS parsing assumptions are documented in: `references/sbs-fields.md`.

## Create a Clawdbot watcher (cron)

Use a Clawdbot cron job to run periodically. The cron job should:
1) `exec` the script
2) If stdout is non-empty, `message.send` it via WhatsApp

Pseudocode for the agent:

- Run:
  - `python3 .../sbs_overhead_check.py ...`
- If stdout trimmed is not empty:
  - send a WhatsApp message with that text

Suggested polling intervals:
- 30–60 seconds is usually enough (given cooldowns)
- Use `--listen-seconds 3..8` so each run can gather a few position frames

## Tuning knobs

- Increase `--radius-km` if you want fewer misses.
- Increase `--listen-seconds` if your feed is busy but you’re missing position updates.
- Use `--cooldown-min` to prevent spam (15–60 minutes recommended).

Popular in IT Ops & Security

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.