.TH BEAST-DUMP 1 "2024-08-24" "SkyView 2.0.0" "User Commands"
.SH NAME
beast-dump \- Utility for analyzing raw ADS-B data in Beast binary format
.SH SYNOPSIS
.B beast-dump
[\fIOPTIONS\fR] [\fIFILE\fR]
.SH 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.
.PP
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.
.SH OPTIONS
.TP
.B \-host \fIstring\fR
Connect to TCP host instead of reading from file
.TP
.B \-port \fIint\fR
TCP port to connect to (default 30005)
.TP
.B \-format \fIstring\fR
Output format: text, json, or csv (default "text")
.TP
.B \-filter \fIstring\fR
Filter by ICAO hex code (e.g., "A1B2C3")
.TP
.B \-types \fIstring\fR
Message types to display (comma-separated)
.TP
.B \-count \fIint\fR
Maximum number of messages to process
.TP
.B \-stats
Show statistics summary
.TP
.B \-verbose
Enable verbose output
.TP
.B \-h, \-help
Show help message and exit
.SH EXAMPLES
.TP
Analyze Beast format file:
.B beast-dump data.bin
.TP
Connect to live Beast stream:
.B beast-dump \-host localhost \-port 30005
.TP
Export to JSON format with statistics:
.B beast-dump \-format json \-stats data.bin
.TP
Filter messages for specific aircraft:
.B beast-dump \-filter A1B2C3 \-verbose data.bin
.TP
Process only first 1000 messages as CSV:
.B beast-dump \-format csv \-count 1000 data.bin
.SH OUTPUT FORMAT
The default text output shows decoded message fields:
.PP
.nf
ICAO: A1B2C3  Type: 17  Time: 12:34:56.789
  Position: 51.4700, -0.4600
  Altitude: 35000 ft
  Speed: 450 kt
  Track: 090°
.fi
.PP
JSON output provides structured data suitable for further processing.
CSV output includes headers and is suitable for spreadsheet import.
.SH MESSAGE TYPES
Common ADS-B message types:
.IP \(bu 2
Type 4/20: Altitude and identification
.IP \(bu 2
Type 5/21: Surface position
.IP \(bu 2
Type 9/18/22: Airborne position (baro altitude)
.IP \(bu 2
Type 10/18/22: Airborne position (GNSS altitude)
.IP \(bu 2
Type 17: Extended squitter ADS-B
.IP \(bu 2
Type 19: Military extended squitter
.SH FILES
Beast format files typically use .bin or .beast extensions.
.SH SEE ALSO
.BR skyview (1),
.BR dump1090 (1)
.SH BUGS
Report bugs at: https://github.com/skyview/skyview/issues
.SH AUTHOR
SkyView Team <admin@skyview.local>