adsb-overhead

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.

1. Przygotuj parametry połączenia: zanotuj adres IP lub hostname hosta z uruchomionym readsb (port 30003), współrzędne geograficzne Twojego domu (szerokość i długość geograficzna) oraz żądany promień detekcji w kilometrach (np. 2 km).

2. Uruchom ręczny test skryptu, aby sprawdzić, czy umiejętność wykrywa samoloty w Twojej okolicy. Wykonaj polecenie python3 ze ścieżką do skryptu sbs_overhead_check.py, przekazując parametry: --host (adres readsb), --port 30003, --home-lat i --home-lon (współrzędne domu), --radius-km (promień), --listen-seconds (czas nasłuchiwania, np. 5 sekund) oraz --cooldown-min (czas między powiadomieniami, np. 15 minut). Jeśli skrypt wypisze linie tekstu, oznacza to nowe alerty; jeśli nic się nie pojawi, nie było samolotów w promieniu podczas testu.

3. Skonfiguruj zadanie cron w Clawdbocie, które będzie uruchamiać skrypt okresowo (co 30–60 sekund to zwykle wystarczające tempo). Zadanie powinno wykonać skrypt i sprawdzić, czy jego wyjście nie jest puste.

4. Powiąż wyjście skryptu z wysyłką wiadomości WhatsApp: jeśli skrypt zwróci tekst (nowy alert), Clawdbot powinien wysłać tę wiadomość na Twój numer WhatsApp za pomocą funkcji message.send.

5. Dostosuj parametry do swoich potrzeb: zmień promień detekcji, aby otrzymywać alerty dla większego lub mniejszego obszaru, zwiększ czas ochłodzenia, jeśli powiadomienia są zbyt częste, lub zmniejsz czas nasłuchiwania w każdym cyklu, aby zmniejszyć obciążenie.

6. Stan umiejętności (informacje o ostatnich alertach) jest automatycznie zapisywany w pliku JSON (~/.clawdbot/adsb-overhead/state.json), dzięki czemu cooldown działa prawidłowo między uruchomieniami.