• Live Carto Map Tiles with Web Mercator projection
• Smooth pan & zoom controls with trackpad gesture support
• Smart tile caching (7-day local cache for instant loading)
• Auto-centering on your GPS location at startup

• Connects to BaseStation protocol feeds (port 30003)
• Automatic reconnection and error recovery
• Tracks ICAO address, callsign, position, altitude, speed, and heading
• 400-mile radius filtering for relevant aircraft only
• Intelligent jump detection to filter out GPS errors

Beautiful color-coded flight paths showing the last 10 minutes of history:

Trails smoothly fade from solid to transparent over time, giving you both altitude and recency information at a glance.

• Military-style contact list sorted by altitude (highest first)
• Real-time status indicators (active ● / recent ● / stale ○)
• Click to select aircraft on map or in list
• Auto-scroll to selected aircraft
• Flight level (FL), speed, heading, and coordinates
• Last-seen timestamps

• Click aircraft on map or in list to highlight
• Selected aircraft show with red icon and yellow selection ring
• List automatically scrolls to center selected aircraft
• Subtle 10% opacity background highlight in list

• Airports - Color-coded by size (large/medium/small)
  • Red markers for major international airports
  • Yellow for medium regional airports
  • Gray for small local airports
  • ICAO identifiers shown at higher zoom levels
  • Smart filtering with 3 modes:
    • Public/Frequent (default) - Shows airports with scheduled service and major hubs
    • All Airports - Shows all public airplane airports
    • Major Only - Shows only large international airports
• Runways - Detailed runway visualization
  • Paved runways shown with thicker lines
  • Automatically displayed for visible airports
  • Only shown at zoom level 8+
• Navaids - Navigational aids overlay
  • VOR/VORTAC in blue triangles
  • NDB in orange triangles
  • DME in purple triangles
  • Ident labels at zoom 9+
• Automatic download - Data files downloaded on first startup (no manual setup required)
• Smart zoom filtering - Overlays automatically adjust visibility based on zoom level
• Toggle controls - Show/hide each overlay type independently via Map Overlays window
• Data from OurAirports (free, public domain)

• Rust (1.70 or later) - Install Rust
• ADS-B Data Source feeding BaseStation protocol to localhost:30003
  • Examples: dump1090, readsb, or any Mode S/ADS-B receiver

# Clone the repository
git clone https://github.com/ccustine/airjedi-desktop.git
cd airjedi-desktop

# Build in release mode (optimized)
cargo build --release

# Run the application
cargo run --release

Note: Aviation data files (airports, runways, navaids) will be automatically downloaded on first startup (~50MB). The app will display overlays once the data is loaded.

The application will:

1. 📍 Detect your GPS location (macOS: CoreLocation, others: IP geolocation)
2. 🗺️ Center the map on your location
3. 📥 Download aviation data in the background (if not already present)
4. 🔌 Connect to localhost:30003 for ADS-B data
5. ✈️ Start tracking aircraft within 400 miles
6. 🛫 Display airport/runway/navaid overlays once data loads

Edit src/tcp_client.rs:

let address = "localhost:30003";  // Change to your BaseStation feed

Edit src/basestation.rs in AircraftTracker::new():

max_distance_miles: 400.0,  // Change radius (in miles)

Edit src/main.rs constants:

const TRAIL_MAX_AGE_SECONDS: f32 = 600.0;     // 10 minutes total
const TRAIL_SOLID_DURATION_SECONDS: f32 = 300.0;  // First 5 min solid
const TRAIL_FADE_DURATION_SECONDS: f32 = 300.0;   // Last 5 min fade

On macOS, the app uses CoreLocation for accurate GPS positioning. On first run, you'll be prompted to grant location permissions. On other platforms, IP-based geolocation is used automatically.

airjedi-desktop/
├── src/
│   ├── main.rs           # UI & rendering (egui framework)
│   ├── aviation_data.rs  # Airport/runway/navaid data loader & renderer
│   ├── basestation.rs    # ADS-B protocol parser & aircraft tracking
│   ├── tcp_client.rs     # Async TCP client with auto-reconnect
│   └── tiles.rs          # Map tile manager with Web Mercator projection
├── data/
│   ├── README.md         # Data download instructions
│   ├── airports.csv      # (download separately)
│   ├── runways.csv       # (download separately)
│   └── navaids.csv       # (download separately)
├── assets/
│   └── airjedi1.png      # Application screenshot
├── Cargo.toml            # Dependencies & build config
├── LICENSE               # Apache 2.0 license
└── README.md             # This file

• 🦀 Rust - Memory-safe, zero-cost abstractions
• 🎨 egui - Immediate mode GUI framework (60 FPS rendering)
• 🌐 eframe - Native windowing and graphics backend
• ⚡ Tokio - Async runtime for TCP connections
• 🗺️ Web Mercator - Standard map projection (EPSG:3857)
• 📦 Carto - Beautiful basemap tiles

┌─────────────────┐
│  ADS-B Receiver │  (dump1090, readsb)
└────────┬────────┘
         │ BaseStation Protocol (TCP :30003)
         ▼
┌─────────────────┐
│   TCP Client    │  (async, auto-reconnect)
└────────┬────────┘
         │ Parse MSG packets
         ▼
┌─────────────────┐
│ Aircraft Tracker│  (position filtering, trail storage)
└────────┬────────┘
         │ Shared state (Arc<Mutex>)
         ▼
┌─────────────────┐
│   UI Renderer   │  (egui @ 500ms updates)
└────────┬────────┘
         │
         ├─► Map tiles (cached from Carto CDN)
         ├─► Aircraft icons & trails
         └─► Information panel

• Haversine formula for accurate great-circle distance
• Center radius check: 400-mile default range
• Jump detection: Rejects >10 mile position jumps
• Resolution: ~100 meter minimum change to record

• Trail history: 10 minutes stored in memory
• Update rate: 500ms (2 Hz) UI refresh
• Cleanup interval: Every 100 received messages
• Aircraft timeout: 3 minutes of inactivity
• Tile cache: SHA256-based filesystem cache with subdomain load balancing

Decodes the following MSG types:

Future enhancements being considered:

• 📈 Aircraft detail popup with full flight information
• 🔍 Configurable filters (altitude range, speed, callsign)
• 💾 Export data to KML/GeoJSON formats
• 📡 Multiple simultaneous data source support
• 🌦️ Weather radar overlay integration
• 🛫 Airport, runway, & navaid overlays ✅
• 🎨 Custom color schemes and themes
• 📊 Historical playback and recording
• 🔔 Aircraft alerts and notifications
• 🌐 Web-based companion app
• 🗺️ Airspace boundaries overlay (Class B, C, D)
• 🛬 Airport frequencies and ATIS information

Contributions are welcome! This is an early-stage project with lots of room for improvement.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Copyright 2025 Chris Custine

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

• OpenStreetMap Contributors - Map data
• CARTO - Beautiful basemap tiles
• OurAirports - Aviation data (airports, runways, navaids)
• egui Community - Excellent immediate mode GUI framework
• ADS-B Community - Open aircraft tracking protocols