Yonder
← Feed Yonder

Feed ATC audio

Share audio from a tower, ground or approach frequency you receive.

Register a frequency

Tell us your airport’s ICAO code, the frequency in MHz, and the service you receive. We’ll confirm whether we can enable your frequency and issue credentials scoped to that feed. Initial coverage is at Toronto Billy Bishop (CYTZ) and San Francisco (KSFO). If you cover another airport, tell us what you receive. Only contribute audio you have permission to receive, record and share in your jurisdiction.

Request ATC credentials

Prepare your audio source

Use an AM airband scanner with audio output or an RTL-SDR receiver with a VHF airband antenna and rtl_fm. You can also use a direct audio URL you operate or are authorized to redistribute. Confirm the channel is intelligible locally before uploading.

Run the SkyStack listener

Download the listener source. Install Go 1.26 or newer and FFmpeg. Extract the archive, then run these commands from its yonder-atc/atc-listener directory on Linux or macOS. Save the supplied token alone in feeder.token before running these commands.

go -C go-listener build -o ../skystack-atc-listener ./cmd/atc-listener
chmod 600 ./feeder.token
export FEEDER_ID=YOUR-STATION-UUID
export FEEDER_TOKEN_FILE=./feeder.token

Save the following as config.json and replace the example feed values with the exact values Yonder registered. For a direct SDR, replace source with rtl_sdr and replace feed_url with frequency_hz in Hz. For a local sound device, use audio with input_format and input_device appropriate for FFmpeg on your platform.

{
  "atc_ingest_url": "https://api.skystackaviation.com/internal/atc/clips",
  "spool_dir": "./spool",
  "feeds": [
    {
      "airport_icao": "YOUR-ICAO",
      "feed_name": "YOUR-REGISTERED-FEED",
      "source": "url",
      "feed_url": "http://127.0.0.1:8000/audio"
    }
  ]
}
./skystack-atc-listener --config ./config.json --check
./skystack-atc-listener --config ./config.json

The listener detects transmissions, splits them into short WAV clips and queues uploads on disk. SkyStack currently stores contributed clips. Automated transcription is paused. Keep the spool directory writable and run one listener per spool.

Check your feed

Watch the logs during a clear transmission to confirm clips are queued and uploaded. If you see authorization errors, check the station ID, token file and registered airport/feed pair before retrying.