Ole-Morten Duesund
be5369c195
The official Debian repositories already contain a package named "skyview" which is associated with NASA's SkyView Virtual Observatory (https://skyview.gsfc.nasa.gov/), a tool for astronomical data visualization. To avoid package naming conflicts and potential confusion for users, this commit renames our ADS-B aircraft tracking application package to "skyview-adsb". This clearly indicates the package's purpose (ADS-B tracking) while maintaining the SkyView brand identity. Changes: - Package name: skyview → skyview-adsb - System user/group: skyview → skyview-adsb - Config directory: /etc/skyview → /etc/skyview-adsb - Data directory: /var/lib/skyview → /var/lib/skyview-adsb - Log directory: /var/log/skyview → /var/log/skyview-adsb - Systemd service: skyview.service → skyview-adsb.service - Documentation path: /usr/share/doc/skyview → /usr/share/doc/skyview-adsb The binaries (/usr/bin/skyview and /usr/bin/beast-dump) remain unchanged as they don't conflict at the filesystem level. This ensures clean installation alongside any existing skyview packages and prevents apt/dpkg conflicts during installation. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
125 lines
No EOL
2.7 KiB
Text
125 lines
No EOL
2.7 KiB
Text
SkyView for Debian
|
|
==================
|
|
|
|
SkyView is a multi-source ADS-B aircraft tracker that connects to dump1090 Beast
|
|
format TCP streams and provides a web-based interface for aircraft tracking.
|
|
|
|
Configuration
|
|
------------
|
|
|
|
The main configuration file is located at:
|
|
/etc/skyview/config.json
|
|
|
|
This file contains:
|
|
- Server configuration (port, host)
|
|
- List of dump1090 sources to connect to
|
|
- Application settings
|
|
|
|
Example configuration for multiple receivers:
|
|
|
|
```json
|
|
{
|
|
"server": {
|
|
"host": "",
|
|
"port": 8080
|
|
},
|
|
"sources": [
|
|
{
|
|
"id": "site1",
|
|
"name": "Site 1 Receiver",
|
|
"host": "192.168.1.100",
|
|
"port": 30005,
|
|
"latitude": 51.4700,
|
|
"longitude": -0.4600,
|
|
"altitude": 50.0,
|
|
"enabled": true
|
|
},
|
|
{
|
|
"id": "site2",
|
|
"name": "Site 2 Receiver",
|
|
"host": "192.168.1.101",
|
|
"port": 30005,
|
|
"latitude": 51.4800,
|
|
"longitude": -0.4500,
|
|
"altitude": 45.0,
|
|
"enabled": true
|
|
}
|
|
],
|
|
"settings": {
|
|
"history_limit": 1000,
|
|
"stale_timeout": 60,
|
|
"update_rate": 1
|
|
}
|
|
}
|
|
```
|
|
|
|
Service Management
|
|
-----------------
|
|
|
|
SkyView runs as a systemd service. Use these commands to manage it:
|
|
|
|
# Start the service
|
|
sudo systemctl start skyview
|
|
|
|
# Stop the service
|
|
sudo systemctl stop skyview
|
|
|
|
# Restart the service
|
|
sudo systemctl restart skyview
|
|
|
|
# Enable auto-start on boot
|
|
sudo systemctl enable skyview
|
|
|
|
# Disable auto-start on boot
|
|
sudo systemctl disable skyview
|
|
|
|
# Check service status
|
|
sudo systemctl status skyview
|
|
|
|
# View logs
|
|
sudo journalctl -u skyview -f
|
|
|
|
Web Interface
|
|
------------
|
|
|
|
Once started, the web interface is available at:
|
|
http://localhost:8080
|
|
|
|
The interface provides:
|
|
- Real-time aircraft tracking map
|
|
- Aircraft table with filtering and sorting
|
|
- Statistics dashboard
|
|
- Coverage and signal strength visualization
|
|
- 3D radar view (optional)
|
|
|
|
Files and Directories
|
|
--------------------
|
|
|
|
/usr/bin/skyview - Main executable
|
|
/etc/skyview/config.json - Configuration file
|
|
/var/lib/skyview/ - Application data directory
|
|
/var/log/skyview/ - Log files
|
|
/lib/systemd/system/skyview.service - Systemd service file
|
|
|
|
Security
|
|
--------
|
|
|
|
SkyView runs as the unprivileged 'skyview' user for security. The service has
|
|
restricted capabilities and filesystem access.
|
|
|
|
Troubleshooting
|
|
--------------
|
|
|
|
1. Check service status:
|
|
sudo systemctl status skyview
|
|
|
|
2. View recent logs:
|
|
sudo journalctl -u skyview --no-pager -l
|
|
|
|
3. Test configuration:
|
|
sudo -u skyview /usr/bin/skyview -config /etc/skyview/config.json
|
|
|
|
4. Check network connectivity to dump1090 sources:
|
|
telnet <host> <port>
|
|
|
|
For more information, visit: https://github.com/skyview/skyview |