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.12 ec86ec6829

    v0.0.12 Stable

    olemd released this 2025-09-02 19:36:38 +02:00 | 1 commits to main since this release

    SkyView v0.0.12 - Comprehensive 3D Radar Enhancements

    Major Features

    3D Radar View Enhancements

    • Aircraft Type Differentiation: Visual distinction between aircraft types (light, medium, heavy, helicopters) with unique geometries and colors
    • Flight Trails with Historical Data: Enhanced 3D flight trails using historical position data with altitude information
    • Interactive 3D Labels: Click-to-show aircraft information with callsign, altitude, and ground speed
    • Signal Quality Visualization: Visual feedback based on receiver signal strength with opacity adjustments
    • Aircraft Direction Indicators: Visual indicators showing aircraft heading and movement direction

    Technical Improvements

    • Pure Go SQLite: Eliminated CGO dependency by switching to modernc.org/sqlite driver
    • Enhanced Performance: Optimized JavaScript rendering and reduced debug logging
    • Improved UI Controls: Added show/hide trails toggle for 3D radar view
    • Better Error Handling: Improved aircraft icon loading and CSS class naming

    Visual and UX Improvements

    • SkyView Branding: Added official logo, favicon, and consistent branding across the application
    • Mobile Responsiveness: Enhanced mobile-friendly design and responsive layouts
    • Improved Clock Display: Fixed UTC and last update time display issues
    • Alphabetical Source Sorting: Sources now display in consistent alphabetical order

    Bug Fixes

    • Fixed aircraft icon fallback to prevent circles when specific types unavailable
    • Corrected signal strength CSS class names to match JavaScript implementation
    • Resolved clock display issues for UTC and last update times
    • Fixed excessive debug logging in JavaScript console
    • Improved logo text visibility with outlines and better color contrast

    Developer Experience

    • Added comprehensive 3D radar controls implementation
    • Enhanced embedded file handling with debug flag controls
    • Improved build system with better SQLite integration
    • Updated documentation for new features and architecture

    Package Information

    • Version: v0.0.12
    • Debian Package: skyview-adsb_0.0.12_amd64.deb (included)
    • Architecture: amd64
    • Size: ~7MB

    Installation

    # Debian/Ubuntu systems
sudo dpkg -i skyview-adsb_0.0.12_amd64.deb

# Or download and run directly
wget https://your-forgejo-instance/olemd/skyview/releases/download/v0.0.12/skyview-adsb_0.0.12_amd64.deb
sudo dpkg -i skyview-adsb_0.0.12_amd64.deb

    What's Next

    The next release will focus on infinite map planes and Level of Detail (LOD) systems for enhanced 3D performance - see issue #45.

    Downloads
  • v0.0.11 9d1dc63a9b

    v0.0.11 Stable

    olemd released this 2025-09-01 10:48:44 +02:00 | 19 commits to main since this release

    SkyView v0.0.11 Release

    🚀 Major Features

    ✅ Dynamic Aircraft Age Calculation - Issue #3 Fixed

    Aircraft age field now shows actual time since last transmission instead of always displaying 0 seconds.

    Backend Improvements:

    • Fixed MarshalJSON in merger.go to calculate age dynamically using time.Since()
    • Added comprehensive test suite for age calculation verification

    Frontend Enhancements:

    • Real-time age calculation using last_update timestamp
    • Periodic updates every second for aircraft table and popups
    • Age increases in real-time without requiring new WebSocket data
    • Proper data staleness indicators for aviation tracking

    ✅ Enhanced Aircraft Legend & Icon System - Issue #13 Fixed

    Completely redesigned aircraft legend with size-differentiated icons for better clarity.

    New Aircraft Icons:

    • 🔶 Light Aircraft (<7,000kg) - Single-engine design
    • 🔸 Medium Aircraft (7,000-34,000kg) - Twin-engine regional
    • 🔹 Large Aircraft (34,000-136,000kg) - Wide-body with winglets
    • 🔷 Heavy Aircraft (>136,000kg) - Jumbo jet with 4 engines
    • 🚁 Helicopter - Detailed rotorcraft design with rotor disc

    UI Improvements:

    • Interactive SVG icons in legend instead of colored squares
    • Enhanced JavaScript categorization logic
    • Improved visual hierarchy and readability

    🔧 Technical Improvements

    Backend Changes

    • Age Calculation Fix: internal/merger/merger.go:205 now uses time.Since(a.LastUpdate).Seconds()
    • Comprehensive Testing: Added merger_test.go with age calculation test coverage
    • Improved Data Quality: Proper staleness indicators for aviation applications

    Frontend Changes

    • Real-time Updates: app.js implements 1-second periodic age updates
    • Client-side Calculation: Both aircraft-manager.js and ui-manager.js calculate age from last_update
    • Enhanced Icons: New SVG aircraft icons with proper categorization
    • Improved UX: Real-time aging without server load or additional WebSocket traffic

    Debian Package

    • Version: Updated to 0.0.11
    • Size: 4.38 MB with all binaries and documentation
    • Contents: skyview, beast-dump, skyview-data utilities
    • SystemD: Complete service integration

    📊 Key Benefits

    ✅ Accurate Data Quality Indicators - Users can identify stale vs. recent aircraft data
    ✅ Real-time Age Updates - Age increases every second in UI
    ✅ Better Visual Clarity - Size-appropriate aircraft icons
    ✅ No Performance Impact - Client-side calculations, no extra server load
    ✅ Aviation-Grade Reliability - Proper data staleness detection for safety

    🛠️ Installation

    Debian/Ubuntu

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

    Manual Installation

    wget https://kode.naiv.no/olemd/skyview/releases/download/v0.0.11/skyview
chmod +x skyview
./skyview --help

    📋 Changelog

    v0.0.11 (2025-09-01)

    • FIXED: Aircraft age field showing 0 seconds (Issue #3)
    • FIXED: Aircraft legend clarity and icon differentiation (Issue #13)
    • ADDED: Real-time age calculation and display updates
    • ADDED: Size-differentiated aircraft icons (light/medium/large/heavy/helicopter)
    • ADDED: Comprehensive age calculation test suite
    • IMPROVED: Data quality indicators for aviation tracking
    • UPDATED: Frontend to display proper aircraft aging without server load

    🔗 Links

    🤖 This release was prepared with Claude Code

    Downloads
  • v0.0.10 66a6b5b9a2

    v0.0.10 Stable

    olemd released this 2025-08-31 20:10:43 +02:00 | 28 commits to main since this release

    SkyView v0.0.10 - SQLite3 CGO Support Fix

    Critical Fix

    This release resolves the critical runtime error: "Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo to work" that prevented SQLite3 database functionality from working.

    Changes

    • CGO Support: Enabled CGO compilation (CGO_ENABLED=1) in all build targets
    • Database Functionality: SQLite3 database operations now work correctly
    • Build Configuration: Updated Makefile and Debian build script to consistently use CGO
    • Binary Changes: Binaries are now dynamically linked (increased from 3.1MB to 4.4MB) to support SQLite3

    Technical Details

    • Modified Makefile build targets to use CGO_ENABLED=1
    • Updated scripts/build-deb.sh to enable CGO compilation
    • All three binaries (skyview, beast-dump, skyview-data) now support SQLite3 operations

    Files Included

    • skyview-adsb_0.0.10_amd64.deb - Updated Debian package with CGO-enabled binaries

    Installation

    # Download and install the Debian package
wget https://kode.naiv.no/olemd/skyview/releases/download/v0.0.10/skyview-adsb_0.0.10_amd64.deb
sudo dpkg -i skyview-adsb_0.0.10_amd64.deb

# Start the service
sudo systemctl enable --now skyview-adsb

    Upgrade Notes

    • Critical: This fix is required for database functionality to work
    • Binaries are now larger due to CGO linking requirements
    • No configuration changes needed - database will initialize properly now

    If you experienced the SQLite3 CGO error with v0.0.9, this release resolves it completely.

    Downloads
  • v0.0.9 779384b748

    v0.0.9 Stable

    olemd released this 2025-08-31 20:04:21 +02:00 | 29 commits to main since this release

    SkyView v0.0.9 - Enhanced Database Management & Systemd Fixes

    Summary

    This release focuses on improved database management, systemd configuration fixes, and Debian packaging enhancements.

    Key Changes

    • Database Management: Enhanced database status monitoring and configuration management
    • Systemd Integration: Corrected systemd service configuration and Debian package setup
    • Documentation: Updated DATABASE.md with comprehensive schema and usage documentation
    • Web Interface: Enhanced web interface with improved database integration and callsign management
    • Testing: Added comprehensive test suite for database functionality

    Files Included

    • skyview-adsb_0.0.8_amd64.deb - Debian package for Ubuntu/Debian systems

    Installation

    # Download and install the Debian package
wget https://kode.naiv.no/olemd/skyview/releases/download/v0.0.9/skyview-adsb_0.0.8_amd64.deb
sudo dpkg -i skyview-adsb_0.0.8_amd64.deb

# Start the service
sudo systemctl enable --now skyview-adsb

    Upgrade Notes

    • The systemd configuration has been updated - restart the service after upgrade
    • Database schema updates are handled automatically
    • Review configuration in /etc/skyview-adsb/config.json after upgrade

    For detailed configuration and usage instructions, see the included documentation.

    Downloads
  • v0.0.8 a63d8d5cd7

    SkyView v0.0.8 - Position Tracking & Package Fixes Stable

    olemd released this 2025-08-31 11:43:57 +02:00 | 44 commits to main since this release

    🚀 What's New in v0.0.8

    ✨ New Features

    • Aircraft Position Tracking Indicators: Enhanced UI now displays how many aircraft have position data vs those without
      • Header shows "X positioned" summary
      • Statistics view includes detailed position tracking cards
      • Backend tracks aircraft with valid position data from all sources

    🐛 Bug Fixes

    • Issue #21: Fixed Debian package upgrade problem where systemd service was incorrectly disabled during upgrades
      • Package upgrades now preserve service enabled state
      • Only stops service temporarily during upgrade, restarts automatically if previously enabled
    • Beast Decoder: Fixed missing PositionValid flag causing position statistics to always show 0 positioned aircraft
      • Beast protocol now correctly marks aircraft with decoded positions as having valid position data

    🔧 Technical Improvements

    • Multi-source data integration works seamlessly between Beast binary and VRS JSON formats
    • Enhanced position validation prevents impossible aircraft movements
    • Improved data fusion logic prioritizes strongest signal for position accuracy

    📦 Package Information

    • Debian Package: skyview-adsb_0.0.8_amd64.deb (2.42 MB)
    • Installation: sudo dpkg -i skyview-adsb_0.0.8_amd64.deb
    • Dependencies: systemd
    • Compatibility: Ubuntu/Debian x86_64 systems

    🌐 Multi-Source Support

    SkyView continues to excel at combining data from multiple receivers:

    • Beast binary format (dump1090/readsb port 30005)
    • VRS JSON format (readsb port 33005)
    • Signal strength-based conflict resolution
    • Real-time position tracking from all sources

    This release significantly improves visibility into tracking quality and fixes critical package management issues. Perfect for ADS-B enthusiasts running multi-receiver setups!

    🤖 Generated with Claude Code

    Downloads
  • 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
  • v0.0.6 3d92ce4481

    v0.0.6 Stable

    olemd released this 2025-08-25 11:04:15 +02:00 | 53 commits to main since this release

    🎯 Aircraft Track Orientation Fix

    This release fixes the primary issue where aircraft track orientations were not propagating properly to the web frontend.

    Key Fixes

    🔧 Frontend Track Orientation

    • Fixed critical bugs in track rotation detection logic
    • Added proper null/undefined handling for track data
    • Increased rotation threshold from 5° to 10° to reduce noise
    • Added first track detection for initial heading assignments
    • Enhanced debugging with detailed orientation update logging

    🚀 Server Reliability

    • Eliminated WebSocket broadcast drops with timeout-based queueing
    • Increased broadcast buffer size (1000 → 2000) to handle traffic bursts
    • Enhanced connection management with proper timeouts and cleanup
    • Added debug endpoint /api/debug/websocket for connection monitoring

    🎛️ Position Validation

    • Relaxed distance thresholds (500nm → 1000nm) for legitimate aircraft movements
    • Reduced false rejections for fast-moving or maneuvering aircraft
    • Improved speed warning thresholds (800kt → 1000kt)

    🔗 WebSocket Management

    • Added exponential backoff reconnection strategy
    • Enhanced error handling and connection state tracking
    • Better debugging and message reception logging

    Impact

    Aircraft icons now properly rotate to show correct heading when track data is received from ADS-B sources. This was the primary issue affecting real-time aircraft tracking accuracy.

    Installation

    Debian/Ubuntu Package

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

    From Source

    git clone https://kode.naiv.no/olemd/skyview.git
cd skyview
go build -o skyview ./cmd/skyview/

    Changelog

    • Fix aircraft track orientation propagation issues (#23)
    • Enhanced WebSocket broadcast reliability
    • Improved position validation thresholds
    • Added comprehensive debugging throughout update pipeline
    • Enhanced connection management and error handling

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

    Downloads
  • v0.0.5 f13f1da2a3

    v0.0.5 Stable

    olemd released this 2025-08-25 08:45:00 +02:00 | 57 commits to main since this release

    SkyView v0.0.5

    Major Changes

    📦 Debian Package Renamed

    • New package name: skyview-adsb (previously skyview)
    • Avoids conflicts with NASA's SkyView Virtual Observatory package in official Debian repositories
    • Ensures clean installation alongside existing packages

    📜 Incremental Changelog

    • Debian packages now include complete version history
    • Users can see all changes when reviewing updates
    • Full compliance with Debian Policy Manual guidelines
    • Better integration with apt changelog and package management tools

    Installation

    Download the Debian package below and install with:

    sudo dpkg -i skyview-adsb_0.0.5_amd64.deb

    Or if you have the previous version installed:

    # Remove old package (if installed)
sudo apt remove skyview

# Install new package
sudo dpkg -i skyview-adsb_0.0.5_amd64.deb

    Package Changes

    • System service: skyview-adsb.service
    • Configuration: /etc/skyview-adsb/config.json
    • User/Group: skyview-adsb
    • Logs: /var/log/skyview-adsb/

    What's Changed

    • Renamed Debian package from skyview to skyview-adsb
    • Implemented incremental changelog generation for Debian packages
    • Fixed shellcheck warnings in build scripts
    • Updated documentation to reflect package changes

    Full Changelog

    All previous versions' changes are now included in the package changelog, viewable with:

    apt changelog skyview-adsb
# or
zcat /usr/share/doc/skyview-adsb/changelog.gz | less

    Contributors

    Built with SkyView's automated build system

    Downloads
  • v0.0.4 a5e542844f

    SkyView v0.0.4 - CPR Position Fix Release Stable

    olemd released this 2025-08-24 23:14:51 +02:00 | 64 commits to main since this release

    This release fixes a critical bug in the CPR (Compact Position Reporting) global decoding algorithm that was causing systematic eastward positioning errors for all aircraft.

    🐛 Critical Bug Fix

    CPR Zone Ambiguity Resolution

    • Fixed systematic eastward bias in aircraft positioning
    • Aircraft approaching Porsgrunn no longer appear near Helsinki
    • Aircraft north of Oslo no longer appear east of Lillestrøm
    • Corrected longitude zone calculations per RTCA DO-260B specification

    🔧 Technical Changes

    Algorithm Corrections:

    • Even frame longitude zones: ni = max(1, NL) (was incorrectly NL-1)
    • Odd frame longitude zones: ni = max(1, NL-1) (unchanged)
    • Implemented frame-consistent zone selection
    • Added comprehensive algorithm documentation with authoritative references

    Documentation:

    • Added references to RTCA DO-260B, ICAO Annex 10, and ADS-B specifications
    • Documented mathematical formulas and implementation rationale
    • Explained zone ambiguity resolution methodology

    🎯 Impact

    • ✅ Eliminates tens-of-kilometers positioning errors
    • ✅ Accurate aircraft positions for all geographic locations
    • ✅ Improved reliability for aviation tracking applications
    • ✅ Algorithm now matches international standards

    📋 Verification

    Tested with aircraft in Norwegian airspace:

    • South of Oslo positioning corrected (was appearing near Skarlandsvatnet)
    • North of Oslo positioning corrected (was appearing east of Lillestrøm)
    • Systematic eastward bias eliminated across all tracked aircraft

    📦 Installation

    Debian/Ubuntu:

    sudo dpkg -i skyview_0.0.4_amd64.deb
sudo systemctl restart skyview

    From Source:

    git checkout v0.0.4
make build

    Resolves: #18

    Downloads
  • v0.0.3 2d7fda717c

    v0.0.3 Stable

    olemd released this 2025-08-24 21:59:46 +02:00 | 68 commits to main since this release

    SkyView v0.0.3 - Enhanced User Experience and Data Quality

    This release focuses on improving the user experience and data quality in SkyView, our real-time ADS-B aircraft tracking application.

    Key Features & Improvements

    🔍 Active User Tracking

    • Added WebSocket client tracking with live "X viewers" display
    • Real-time visibility into how many users are actively monitoring air traffic

    📦 Package Management Enhancements

    • Automatic changelog generation for Debian packages
    • Improved package metadata and documentation

    ✈️ Data Quality Improvements

    • Fixed speed validation: Removed the artificial 600kt speed cap that was incorrectly filtering legitimate high-speed aircraft
    • Enhanced corrupt data detection: Better algorithms for identifying and filtering truly corrupted ADS-B messages
    • More accurate aircraft tracking with reduced false positives

    📚 Documentation Updates

    • Improved installation and configuration documentation
    • Better error handling explanations
    • Updated architecture documentation

    Installation

    Debian/Ubuntu Package Installation

    ```bash

    Download and install the .deb package

    sudo dpkg -i skyview_0.0.3_amd64.deb

    Install any missing dependencies

    sudo apt-get install -f

    Start SkyView service

    sudo systemctl enable skyview
    sudo systemctl start skyview
    ```

    The SkyView web interface will be available at `http://localhost:8080` by default.

    Configuration

    Configuration files are located in `/etc/skyview/`. The package includes:

    • Sample configuration files
    • Systemd service files
    • Complete changelog documentation

    Technical Notes

    This release maintains full backward compatibility with existing configurations. The speed validation improvements specifically benefit tracking of:

    • Military aircraft operating at high speeds
    • Commercial aircraft during emergency procedures
    • Test flights and ferry flights

    The WebSocket client tracking feature adds minimal overhead while providing valuable operational insights.

    Changelog

    Complete changelog details are included in the Debian package documentation (`/usr/share/doc/skyview/changelog.gz`).

    Full package: skyview_0.0.3_amd64.deb
    Platform: Linux AMD64
    Go Version: Compatible with Go 1.19+

    Downloads