radio-copilot

Predict satellite passes (NOAA APT, METEOR LRPT, ISS) for a configured latitude/longitude and send WhatsApp alerts with manual dish alignment info (AOS/LOS azimuth+elevation, track direction, inclination). Use when setting up or operating a zero-AI pass scheduler/orchestrator for SDR satellite reception, including configuring NORAD IDs, minimum elevation, alert lead time, and optional remote capture/decode hooks (Pi RTL-SDR capture + Jetson SatDump decode).

1. Przygotuj katalog konfiguracyjny: utwórz folder ~/.clawdbot/radio-copilot i skopiuj do niego plik config.example.json jako config.json, a następnie ustaw uprawnienia dostępu (chmod 600) aby chronić dane wrażliwe.

2. Edytuj plik konfiguracyjny: otwórz config.json i wprowadź swoją szerokość i długość geograficzną, numery NORAD satelitów, które chcesz monitorować (np. NOAA 18, METEOR M2-3, ISS), minimalną wysokość elewacji dla alertów oraz numer telefonu WhatsApp do wysyłania powiadomień.

3. Uruchom orchestrator ręcznie: wykonaj polecenie python3 scripts/orchestrator.py aby sprawdzić, czy konfiguracja działa poprawnie i czy otrzymujesz alerty z danymi przejścia (azymut/elewacja na początek i koniec, kierunek śledzenia, inklinacja).

4. Zaplanuj automatyczne uruchamianie: dodaj orchestrator do crona systemowego, aby uruchamiał się co 5 minut — w ten sposób będziesz zawsze na bieżąco z nadchodzącymi przejściami satelitów bez ręcznego sprawdzania.

5. Opcjonalnie: jeśli posiadasz Raspberry Pi z tunerem RTL-SDR lub Jetson do dekodowania, skonfiguruj haki przechwytywania i dekodowania w pliku config.json — skill będzie wtedy automatycznie nagrywać i dekodować sygnały podczas przejść.