Files
website/docs/radio-tracker.md
Stan Runge f954881bcc
All checks were successful
Deploy production / deploy (push) Successful in 1m21s
radio: quiet hours for reminders (default 23:00-07:30 Amsterdam, RADIO_QUIET_HOURS overrides)
2026-10-26 17:18:59 +00:00

28 lines
1.8 KiB
Markdown

# Radio tracker (/trackers/radio)
Private (owner-only, 404 for everyone else) tracker for Opa Chiel's scanner hobby.
- **Frequencies** (`radio.frequencies`): freq in Hz, mode, band (marine/air/ham/pmr/other), name,
location, notes, marine channel, tags. Seeded from Opa's lists (airband banks 4-6, marine banks
7-10) and the extras in his notes (Haagse ronde, KLM ronde, ISS downlink, ADS-B).
- **Scanner banks** (`radio.channels`): Uniden UBC125XLT layout, 10 banks x 50 channels.
`/trackers/radio/banks.csv` exports all 500 channels in BC125AT_SS column order.
- **Nets** (`radio.nets`): days (1 = Mon .. 7 = Sun) and "HH:MM" times in Europe/Amsterdam.
- **ISS passes** (`radio.iss_passes`, `radio.iss_tle`): computed in `scripts/radio.ts iss` with
satellite.js from the Celestrak TLE (CATNR 25544) for Gouda (52.011 N, 4.711 E), 5 days ahead.
- **Log** (`radio.log`): what was heard, linked to a frequency.
## Jobs (systemd user timers on stan-ovh, copies in deploy/systemd)
- `radio-iss.timer`: daily 04:15 Amsterdam, `bun scripts/radio.ts iss` in the app container.
- `radio-remind.timer`: every minute, `bun scripts/radio.ts remind`. Sends an ntfy push
10 minutes before each net with `remind` on and each ISS pass with max elevation >= 10 deg.
`radio.reminders` makes each reminder fire once.
- Both read `~/.config/radio.env` (mode 600): `RADIO_NTFY_URL` (ntfy topic URL), optional
`RADIO_NTFY_TOKEN`. Log: `~/.local/state/radio.log`.
- `bun scripts/radio.ts upcoming` prints the next 24 h of reminders without sending.
## Quiet hours
Reminders whose send time (event minus 10 min) falls in 23:00-07:30 Europe/Amsterdam are skipped. Override with `RADIO_QUIET_HOURS=HH:MM-HH:MM` (or `off`) in `~/.config/radio.env`; the page shows the code default (`QUIET_HOURS` in `src/lib/radio/index.ts`). `bun scripts/radio.ts upcoming` marks skipped reminders as QUIET-SKIP.