.TH SKYVIEW 1 "2025-08-24" "SkyView 0.0.3" "User Commands"
.SH NAME
skyview \- Multi-source ADS-B aircraft tracker with Beast format support
.SH SYNOPSIS
.B skyview
[\fIOPTIONS\fR]
.SH DESCRIPTION
SkyView is a standalone application that connects to multiple dump1090 Beast
format TCP streams and provides a modern web frontend for aircraft tracking.
It features real-time aircraft tracking, signal strength analysis, coverage
mapping, and 3D radar visualization.
.PP
The application serves a web interface on port 8080 by default and connects
to one or more Beast format data sources (typically dump1090 instances) to
aggregate aircraft data from multiple receivers.
.SH OPTIONS
.TP
.B \-config \fIstring\fR
Path to configuration file (default "config.json")
.TP
.B \-port \fIint\fR
HTTP server port (default 8080)
.TP
.B \-debug
Enable debug logging
.TP
.B \-version
Show version information and exit
.TP
.B \-h, \-help
Show help message and exit
.SH FILES
.TP
.I /etc/skyview/config.json
System-wide configuration file
.TP
.I ~/.config/skyview/config.json
Per-user configuration file
.SH EXAMPLES
.TP
Start with default configuration:
.B skyview
.TP
Start with custom config file:
.B skyview \-config /path/to/config.json
.TP
Start on port 9090 with debug logging:
.B skyview \-port 9090 \-debug
.SH CONFIGURATION
The configuration file uses JSON format with the following structure:
.PP
.nf
{
  "sources": [
    {
      "id": "source1",
      "name": "Local Receiver",
      "host": "localhost",
      "port": 30005,
      "latitude": 51.4700,
      "longitude": -0.4600
    }
  ],
  "web": {
    "port": 8080,
    "assets_path": "/usr/share/skyview/assets"
  }
}
.fi
.SH WEB INTERFACE
The web interface provides:
.IP \(bu 2
Interactive map view with aircraft markers
.IP \(bu 2
Aircraft data table with filtering and sorting
.IP \(bu 2
Real-time statistics and charts
.IP \(bu 2
Coverage heatmaps and range circles
.IP \(bu 2
3D radar visualization
.SH SEE ALSO
.BR beast-dump (1),
.BR dump1090 (1)
.SH BUGS
Report bugs at: https://kode.naiv.no/olemd/skyview/issues
.SH AUTHOR
Ole-Morten Duesund <glemt.net>