BEAST-DUMP(1)

NAME
beast-dump - Utility for analyzing raw ADS-B data in Beast binary format

SYNOPSIS
beast-dump [OPTIONS] [FILE]

DESCRIPTION
beast-dump is a command-line utility for analyzing and decoding ADS-B (Automatic Dependent Surveillance-Broadcast) data stored in Beast binary format. It can read from files or connect to Beast format TCP streams to decode and display aircraft messages.

The Beast format is a compact binary representation of Mode S/ADS-B messages commonly used by dump1090 and similar software-defined radio applications for aircraft tracking.

OPTIONS

-host string
    Connect to TCP host instead of reading from file

-port int
    TCP port to connect to (default 30005)

-format string
    Output format: text, json, or csv (default "text")

-filter string
    Filter by ICAO hex code (e.g., "A1B2C3")

-types string
    Message types to display (comma-separated)

-count int
    Maximum number of messages to process

-stats
    Show statistics summary

-verbose
    Enable verbose output

-h, -help
    Show help message and exit

EXAMPLES

Analyze Beast format file:
    beast-dump data.bin

Connect to live Beast stream:
    beast-dump -host localhost -port 30005

Export to JSON format with statistics:
    beast-dump -format json -stats data.bin

Filter messages for specific aircraft:
    beast-dump -filter A1B2C3 -verbose data.bin

Process only first 1000 messages as CSV:
    beast-dump -format csv -count 1000 data.bin

OUTPUT FORMAT
The default text output shows decoded message fields:

ICAO: A1B2C3  Type: 17  Time: 12:34:56.789
  Position: 51.4700, -0.4600
  Altitude: 35000 ft
  Speed: 450 kt
  Track: 090°

JSON output provides structured data suitable for further processing. CSV output includes headers and is suitable for spreadsheet import.

MESSAGE TYPES
Common ADS-B message types:

•   Type 4/20: Altitude and identification

•   Type 5/21: Surface position

•   Type 9/18/22: Airborne position (baro altitude)

•   Type 10/18/22: Airborne position (GNSS altitude)

•   Type 17: Extended squitter ADS-B

•   Type 19: Military extended squitter

FILES
Beast format files typically use .bin or .beast extensions.

SEE ALSO
skyview(1), dump1090(1)

BUGS
Report bugs at: https://github.com/skyview/skyview/issues

AUTHOR
SkyView Team <admin@skyview.local>