olemd/skyview

Watch

Fork 0

14 releases 14 tags

RSS feed

v0.0.15 326546ad2c

SkyView v0.0.15 - GNSS Height Separated from Barometric Altitude Stable
olemd released this 2026-09-29 15:09:59 +02:00 | 2 commits to main since this release
SkyView v0.0.15 - GNSS Height Separated from Barometric Altitude

A small follow-up release with one decoding fix and one packaging fix.

Decoding
- ADS-B GNSS height (TC 20-22) no longer overwrites barometric altitude. Airborne position messages with type codes 20-22 carry GNSS height above the WGS84 ellipsoid, which can differ from barometric altitude by several hundred feet. The decoder stored it in the same field as barometric altitude, so aircraft reporting both could jump in altitude.
  - GNSS height now goes to GeomAltitude.
  - The displayed altitude stays barometric whenever a barometric value has been received, and falls back to GNSS height only for aircraft that report nothing else. This is the same rule already used for VRS sources.
Note on the encoding

Decoders disagree on how the TC 20-22 altitude field is encoded:
- dump1090-fa and readsb: the same 25 ft coding as barometric altitude
- pyModeS and "The 1090 Megahertz Riddle": plain metres
SkyView follows dump1090-fa and readsb, the decoders it is validated against. The metres reading caps at 4,095 m (13,435 ft), which cannot represent aircraft at cruise altitude. TC 20-22 messages are rare: none appeared in a 5-minute capture from the test receiver, so this change has not been verified against live data.

Packaging
- Debian changelog fixed. /usr/share/doc/skyview-adsb/changelog.gz now lists only each release's own commits. The v0.0.13 and v0.0.14 packages listed the 20 most recent commits of the whole history under the newest version.
Package
- Debian package: skyview-adsb_0.0.15_amd64.deb (7.5 MB, amd64)
- SHA-256: f727eac9c01008eaddec08deab93424771315af97f3aef3d267e8a54fd9d008a
```
sudo dpkg -i skyview-adsb_0.0.15_amd64.deb
```
Container image:
```
BUILDAH_FORMAT=docker podman build \
  --build-arg BUILD_DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  --build-arg GIT_REVISION=v0.0.15 \
  -t skyview:v0.0.15 .
```
🤖 Generated with Claude Code
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- skyview-adsb_0.0.15_amd64.deb
  1 download · 2026-09-29 15:11:14 +02:00 · 7.4 MiB

v0.0.14 e168b57f3d

SkyView v0.0.14 - WebSocket Origin Check, Gillham Altitude and Local CPR Stable
olemd released this 2026-09-29 14:53:54 +02:00 | 5 commits to main since this release
SkyView v0.0.14 - WebSocket Origin Check, Gillham Altitude and Local CPR

This follow-up to v0.0.13 includes a security fix for the live data stream, better decoding for older transponders and weak reception, and a corrected man page.

⚠️ Upgrade note: reverse proxies

The WebSocket endpoint (/ws) now accepts browser connections only when the Origin matches the request's Host header. Behind a reverse proxy, the proxy must forward the original Host header, otherwise live updates stop:
- Caddy: works as-is, because reverse_proxy passes Host through to HTTP backends
- nginx: add proxy_set_header Host $host;. The default rewrites Host. See the new Reverse Proxy section in docs/CONFIGURATION.md.
Rejected connections are logged as Rejected WebSocket connection from origin ....

Security
- Cross-site WebSocket hijacking: the server previously accepted WebSocket connections from any origin. Any website a visitor opened could read the live data stream through the visitor's browser, including from SkyView instances reachable only on a private network. Non-browser clients (no Origin header) are still accepted.
Decoding
- Gillham (Mode C) altitude: the 100 ft altitude coding used by older transponders, and by all transponders above 50,175 ft, was reported as unknown. It is now decoded for both Mode S replies and ADS-B positions. Tests cover every altitude from -1,200 to 126,700 ft plus the pyModeS reference vectors.
- Local CPR decoding: once an aircraft has a position, a single position frame is decoded relative to it, without waiting for a complete even/odd pair. This keeps positions updating when frames are missed at the edge of coverage or when an aircraft crosses a zone boundary. An aircraft's first position still always requires a complete pair.
On a strong receiver neither change makes a measurable difference. In testing, no Gillham altitudes appeared in 60 s, and 183 of 189 position frames were decoded with or without local decoding. The gains are for older aircraft and weaker or intermittent reception.

Documentation
- The skyview(1) man page listed -port and -debug, which do not exist. It now documents -config, -server, -sources, -verbose and -version, the actual config file search order, and a valid configuration example.
- New reverse proxy section in docs/CONFIGURATION.md.
Known issues
- The Debian changelog (/usr/share/doc/skyview-adsb/changelog.gz) lists the 20 most recent commits under the newest version instead of only the commits since the previous release. This is a long-standing bug in the package build script and will be fixed in the next release.
- ADS-B GNSS-height positions (TC 20-22) may show an incorrect altitude.
Package
- Debian package: skyview-adsb_0.0.14_amd64.deb (7.5 MB, amd64)
- SHA-256: dd760d3f8835bcf0b02c3e9c7c9eabcd649b1945e5022462e1b25b1d11e2258f
```
sudo dpkg -i skyview-adsb_0.0.14_amd64.deb
```
Container image:
```
BUILDAH_FORMAT=docker podman build \
  --build-arg BUILD_DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  --build-arg GIT_REVISION=v0.0.14 \
  -t skyview:v0.0.14 .
```
🤖 Generated with Claude Code
Downloads
- Source code (ZIP)
  0 downloads
- Source code (TAR.GZ)
  0 downloads
- skyview-adsb_0.0.14_amd64.deb
  1 download · 2026-09-29 14:55:19 +02:00 · 7.4 MiB

v0.0.13 d272d11ab0

SkyView v0.0.13 - Correct Beast Decoding and Stability Fixes Stable

olemd released this 2026-09-29 14:35:54 +02:00 | 10 commits to main since this release

SkyView v0.0.13 - Correct Beast Decoding and Stability Fixes

This release fixes the Mode S / ADS-B decoder. Before it, Beast sources placed some aircraft hundreds of kilometres off, reported roughly half the real altitude, and discarded more than half of all messages. Output now matches dump1090 on the same feed. The release also includes a security fix and a set of database, configuration and packaging fixes.

If you switched to a VRS JSON source because Beast data looked wrong, you can switch back.

Measured against dump1090 (same live Beast feed)

	v0.0.12	v0.0.13
Messages decoded	~42%	99.7%
Positions more than 5 km off	yes (one aircraft ~680 km off)	none
Positions rejected by validation	13 in 3 min	0
Altitude	roughly half the real value	median 25 ft from dump1090
Squawk	almost never available	17/17 matching

Decoder fixes

CPR position decoding (#35, #24)
- Odd frames used the even-frame zone size, which shifted positions by about 110 km at Nordic latitudes.
- Negative zone indices were discarded.
- Pairs that straddle a longitude-zone boundary or are too old to pair are now rejected.
- The position is taken from the newest frame.
- Surface positions now use the 90° surface grid, resolved against the receiver location.
ADS-B altitude was decoded with the wrong bit layout, which roughly halved it (18,800 ft instead of 38,000 ft).
Mode S surveillance replies (DF0/4/5/16/20/21) (#24)
- These replies were all discarded as CRC failures.
- The aircraft address is now recovered from the CRC residue. A reply is accepted only if its address was recently confirmed by a message with a clean CRC, so corrupted replies cannot create phantom aircraft.
- Mode S altitude (AC13) and squawk (ID13) are now decoded correctly.
Beast framing: escaped 0x1A bytes in the timestamp and signal fields misaligned frames. This affected about 0.3% of frames.
Memory: CPR state for aircraft that stopped transmitting is now released.

Position validation (#24)

Positions from different receivers a few milliseconds apart are no longer rejected as "impossible speed", and slightly out-of-order timestamps are no longer rejected either.
A bad first position no longer blocks all correct positions after it. Three consistent positions replace it.

Security

All dynamic values inserted into the page with innerHTML are now sanitized to prevent XSS.

Database

SQLite pragmas were never applied: WAL, synchronous mode, cache size and foreign keys were all off. The driver ignored the parameter format in the connection string.
auto_vacuum and page-size changes now take effect.
The server now runs schema migrations on startup. Previously a database not prepared by skyview-data had no tables, and every history write failed.

Configuration

settings are now applied. history_limit, stale_timeout and update_rate were read but never used. Defaults follow docs/CONFIGURATION.md: 1000 history points and a 60 s stale timeout. Out-of-range values are adjusted, with a warning in the log.
A missing or invalid -config file is now fatal. Previously the server silently started with a default localhost:30005 source.
IPv6 source addresses now work.

Build and packaging

cmd/skyview/main.go and update-database.sh were never committed, because an over-broad .gitignore pattern hid them. A fresh clone can now build all binaries.
The container build works again. Previously it built from the repository root, which has no Go files. Images now carry OCI labels and /etc/build-info with the build date and git revision.
skyview -version reports the build version.
WebSocket compression is enabled.

Upgrade notes

The effective stale timeout changes from 15 s to 60 s unless stale_timeout is set.
Services started with a wrong -config path will now fail to start instead of running with defaults. The Debian service uses /etc/skyview-adsb/config.json, which the package installs.

Known limitations

Altitude in Gillham (100 ft) coding, used by old transponders and above 50,175 ft, is reported as unknown.
ADS-B GNSS-height positions (TC 20-22) may show an incorrect altitude.
The man page for skyview still lists -port and -debug. The actual flags are -server, -sources, -verbose and -version.

Package

Debian package: skyview-adsb_0.0.13_amd64.deb (7.5 MB, amd64)
SHA-256: e1287e272b72c040ce1a0fb1292fd692c32d4c93142afa6820d05a986eefebbc

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

Container image:

BUILDAH_FORMAT=docker podman build \
  --build-arg BUILD_DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  --build-arg GIT_REVISION=v0.0.13 \
  -t skyview:v0.0.13 .

🤖 Generated with Claude Code

Downloads

Source code (ZIP)
0 downloads
Source code (TAR.GZ)
0 downloads

skyview-adsb_0.0.13_amd64.deb
1 download · 2026-09-29 14:37:35 +02:00 · 7.4 MiB

v0.0.12 ec86ec6829

v0.0.12 Stable
olemd released this 2025-09-02 19:36:38 +02:00 | 29 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
- Source code (ZIP)
  8 downloads
- Source code (TAR.GZ)
  12 downloads
- skyview-adsb_0.0.12_amd64.deb
  28 downloads · 2025-09-02 19:43:58 +02:00 · 6.8 MiB

v0.0.11 9d1dc63a9b

v0.0.11 Stable
olemd released this 2025-09-01 10:48:44 +02:00 | 47 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
- Repository: https://kode.naiv.no/olemd/skyview
- Documentation: See README.md and docs/ directory
- Issues: Report bugs and feature requests in the issue tracker
🤖 This release was prepared with Claude Code
Downloads
- Source code (ZIP)
  6 downloads
- Source code (TAR.GZ)
  8 downloads
- skyview-adsb_0.0.11_amd64.deb
  18 downloads · 2025-09-01 10:50:32 +02:00 · 4.2 MiB

v0.0.10 66a6b5b9a2

v0.0.10 Stable
olemd released this 2025-08-31 20:10:43 +02:00 | 56 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
- Source code (ZIP)
  9 downloads
- Source code (TAR.GZ)
  14 downloads
- skyview-adsb_0.0.10_amd64.deb
  21 downloads · 2025-08-31 20:12:56 +02:00 · 4.2 MiB

v0.0.9 779384b748

v0.0.9 Stable
olemd released this 2025-08-31 20:04:21 +02:00 | 57 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
- Source code (ZIP)
  12 downloads
- Source code (TAR.GZ)
  12 downloads
- skyview-adsb_0.0.8_amd64.deb
  18 downloads · 2025-08-31 20:04:52 +02:00 · 3 MiB

v0.0.8 a63d8d5cd7

SkyView v0.0.8 - Position Tracking & Package Fixes Stable
olemd released this 2025-08-31 11:43:57 +02:00 | 72 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
- Source code (ZIP)
  7 downloads
- Source code (TAR.GZ)
  8 downloads
- skyview-adsb_0.0.8_amd64.deb
  21 downloads · 2025-08-31 11:44:52 +02:00 · 2.3 MiB

v0.0.7 276c51517f

v0.0.7 Stable
olemd released this 2025-08-31 11:13:14 +02:00 | 77 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
- Source code (ZIP)
  7 downloads
- Source code (TAR.GZ)
  9 downloads
- skyview-adsb_0.0.7_amd64.deb
  19 downloads · 2025-08-31 11:15:46 +02:00 · 2.3 MiB

v0.0.6 3d92ce4481

v0.0.6 Stable
olemd released this 2025-08-25 11:04:15 +02:00 | 81 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
- Source code (ZIP)
  4 downloads
- Source code (TAR.GZ)
  5 downloads
- skyview-adsb_0.0.6_amd64.deb
  17 downloads · 2025-08-25 11:04:16 +02:00 · 2.3 MiB

1 2

SkyView v0.0.15 - GNSS Height Separated from Barometric Altitude Stable

SkyView v0.0.15 - GNSS Height Separated from Barometric Altitude

Decoding

Note on the encoding

Packaging

Package

SkyView v0.0.14 - WebSocket Origin Check, Gillham Altitude and Local CPR Stable

SkyView v0.0.14 - WebSocket Origin Check, Gillham Altitude and Local CPR

⚠️ Upgrade note: reverse proxies

Security

Decoding

Documentation

Known issues

Package

SkyView v0.0.13 - Correct Beast Decoding and Stability Fixes Stable

SkyView v0.0.13 - Correct Beast Decoding and Stability Fixes

Measured against dump1090 (same live Beast feed)

Decoder fixes

Position validation (#24)

Security

Database

Configuration

Build and packaging

Upgrade notes

Known limitations

Package

v0.0.12 Stable

SkyView v0.0.12 - Comprehensive 3D Radar Enhancements

Major Features

3D Radar View Enhancements

Technical Improvements

Visual and UX Improvements

Bug Fixes

Developer Experience

Package Information

Installation

What's Next

v0.0.11 Stable

SkyView v0.0.11 Release

🚀 Major Features

✅ Dynamic Aircraft Age Calculation - Issue #3 Fixed

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

🔧 Technical Improvements

Backend Changes

Frontend Changes

Debian Package

📊 Key Benefits

🛠️ Installation

Debian/Ubuntu

Manual Installation

📋 Changelog

v0.0.11 (2025-09-01)

🔗 Links

v0.0.10 Stable

SkyView v0.0.10 - SQLite3 CGO Support Fix

Critical Fix

Changes

Technical Details

Files Included

Installation

Upgrade Notes

v0.0.9 Stable

SkyView v0.0.9 - Enhanced Database Management & Systemd Fixes

Summary

Key Changes

Files Included

Installation

Upgrade Notes

SkyView v0.0.8 - Position Tracking & Package Fixes Stable

🚀 What's New in v0.0.8

✨ New Features

🐛 Bug Fixes

🔧 Technical Improvements

📦 Package Information

🌐 Multi-Source Support

v0.0.7 Stable

SkyView v0.0.7 - VRS JSON Format Support

🎉 Major New Feature: VRS JSON Protocol Support

✨ What's New

🔧 VRS JSON Integration