olemd/skyview
1
0
Fork 0
Code Issues 12 Pull requests Projects Releases 11 Packages Wiki Activity Actions

11 releases 11 tags

RSS feed
  • v0.0.7 276c51517f

    v0.0.7 Stable

    olemd released this 2025-08-31 11:13:14 +02:00 | 49 commits to main since this release

    SkyView v0.0.7 - VRS JSON Format Support

    🎉 Major New Feature: VRS JSON Protocol Support

    This release introduces comprehensive VRS (Virtual Radar Server) JSON format support, providing a modern alternative to Beast binary protocol while maintaining full backward compatibility.

    ✨ What's New

    🔧 VRS JSON Integration

    • TCP JSON Streaming: Direct support for readsb --net-vrs-port output (typically port 33005)
    • Human-Readable Format: JSON instead of binary Beast protocol for easier debugging and integration
    • Mixed Sources: Use Beast binary and VRS JSON sources simultaneously in the same deployment
    • Plug-and-Play: Simple configuration with "format": "vrs" in source settings

    📊 Enhanced Aircraft Data Model

    • Extended Metadata: Registration, aircraft type, operator information from VRS sources
    • Position Sources: Automatic identification of ADS-B, MLAT, TIS-B, and satellite positions
    • Validity Tracking: Enhanced data quality indicators for each field
    • Rich Context: More detailed aircraft information than traditional Beast sources

    ⚙️ Configuration Flexibility

    • Format Selection: Choose between "beast" or "vrs" formats per source
    • Port Flexibility: Standard ports 30005 (Beast) and 33005 (VRS) supported
    • Backward Compatible: Existing Beast configurations work unchanged
    • Multi-Protocol: Deploy mixed Beast/VRS setups for redundancy and coverage

    🚀 Configuration Example

    {
  "sources": [
    {
      "id": "beast-primary",
      "name": "dump1090 Beast",
      "host": "192.168.1.100",
      "port": 30005,
      "format": "beast",
      "enabled": true
    },
    {
      "id": "vrs-secondary", 
      "name": "readsb VRS JSON",
      "host": "192.168.1.101",
      "port": 33005,
      "format": "vrs",
      "enabled": true
    }
  ]
}

    🛠️ Technical Implementation

    New Components

    • VRS JSON Parser (internal/vrs/parser.go): Stream parser for newline-delimited JSON
    • VRS TCP Client (internal/client/vrs.go): Robust client with automatic reconnection
    • Enhanced Aircraft Model: Extended with VRS-specific fields and validity flags
    • Multi-Format Client Manager: Unified handling of Beast and VRS sources

    Testing & Validation

    ✅ Live tested against readsb VRS JSON streams
    ✅ Verified mixed-format operation with Beast sources
    ✅ Confirmed aircraft data parsing and position tracking
    ✅ Validated metadata extraction and source identification

    📈 Advantages of VRS Format

    • Simplicity: Human-readable JSON vs binary Beast protocol
    • Debugging: Easy to inspect data streams and diagnose issues
    • Modern Integration: Better compatibility with current readsb versions
    • Rich Data: Additional aircraft metadata (registration, type, operator)
    • Flexible Updates: Configurable intervals with --net-vrs-interval

    🔄 Migration Guide

    For Existing Users

    No changes required! Existing Beast configurations continue to work unchanged.

    For New VRS Sources

    1. Enable VRS in readsb: --net-vrs-port 33005
    2. Add VRS source to SkyView config with "format": "vrs"
    3. Optionally mix with existing Beast sources for redundancy

    Readsb Configuration

    # Enable both Beast and VRS outputs
readsb --net-bo-port 30005 --net-vrs-port 33005 --net-vrs-interval 2.0

    📦 Installation

    Debian Package (Recommended)

    wget https://kode.naiv.no/olemd/skyview/releases/download/v0.0.7/skyview-adsb_0.0.7_amd64.deb
sudo dpkg -i skyview-adsb_0.0.7_amd64.deb
sudo systemctl start skyview-adsb

    Configuration

    Edit /etc/skyview-adsb/config.json to add your sources, then:

    sudo systemctl restart skyview-adsb
sudo systemctl enable skyview-adsb

    🏗️ Development Improvements

    • Enhanced documentation with VRS format examples
    • Updated architecture documentation for multi-format support
    • Comprehensive error handling and recovery for VRS streams
    • Improved aircraft data model with extensible field validation

    🙏 Acknowledgments

    This release addresses community feedback for simpler integration with modern readsb deployments while preserving full compatibility with existing dump1090 Beast setups.

    Full Changelog: https://kode.naiv.no/olemd/skyview/compare/v0.0.5...v0.0.7

    For issues and feedback: https://kode.naiv.no/olemd/skyview/issues

    Downloads