Ole-Morten Duesund
2d7fda717c
Update all version references in preparation for v0.0.3 release: - Debian package control file - Manual pages for skyview and beast-dump - Web interface header display - README installation instructions - Documentation examples 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
95 lines
No EOL
2.5 KiB
Groff
95 lines
No EOL
2.5 KiB
Groff
.TH BEAST-DUMP 1 "2025-08-24" "SkyView 0.0.3" "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://kode.naiv.no/olemd/skyview/issues
|
|
.SH AUTHOR
|
|
Ole-Morten Duesund <glemt.net> |