APRS PropView

• Digipeater — WIDEn-N compliant packet digipeating via KISS TNC (serial or TCP)
• IGate — Bidirectional RF ↔ APRS-IS gateway with proper q-construct handling and third-party IS→RF forwarding
• RF Station Tracking — Separate list of stations heard directly on RF
• APRS-IS Station Tracking — Separate list of stations received from APRS-IS
• Propagation Map — Interactive Leaflet map with APRS sprite icons, adjustable marker size, directional arrowed path lines, map-created APRS objects, and light/dark theme toggle
• Maidenhead Grid Overlay — Zoom-aware field, square, and subsquare labels with click-to-select support for the watched-path builder
• QTH and Watch Scopes — One-click 25/50/100-mile local range rings at the home station or any configured watched-path target, with its target-area radius highlighted separately
• Custom/Offline Map Tiles — Point the map at a local XYZ tile server or use the map Cache control to store the visible map area in map_tile_cache/ for offline/field use
• Dual Propagation Meters — Header gauges: "VHF Propagation My Station" (direct-heard RF only) and "Regional VHF Propagation" (all RF including via digipeater), each with configurable scoring thresholds
• Evidence Confidence & Event Lifecycle — Each propagation meter explains its freshness and sample confidence; sustained one-minute observations progress through developing, confirmed/peak, and fading event phases
• Unified Source Health — Header panel reports LIVE, DELAYED, STALE, WAITING, OFFLINE, or configured state for RF, APRS-IS, weather, alerts, GOES GLM, radar, and satellite imagery
• Configurable Path Lines — Directional station-to-station lines support distance or custom coloring, weight, opacity, solid/dashed/dotted patterns, and offset arrows for bidirectional paths
• Digipeater-Routed Lines — RF stations heard through known digipeaters draw TX-to-digi-to-RX paths instead of misleading direct-heard lines
• Moving Station Cleanup — If APRS-IS later reports the same moving callsign at a newer different position, the stale RF marker and path line are removed from the map
• Callsign Labels — Toggle persistent callsign labels above each station icon on the map
• Map Callsign Search — Expandable/collapsible map search box with Enter-to-jump and Esc-to-collapse keyboard handling
• Auto-Fit Zoom — Automatically zoom the map to fit all visible stations; zooms back in as stations expire; overridden by manual pan/zoom
• Station Ghosting — Configurable fade effect (pulsing dashed border) for stations not heard recently
• Station Expiry — Automatically remove stations from the map after a configurable "last heard" timeout
• Mobile Companion — Touch-optimized /mobile page with bottom tab bar for phone browsers (via Tailscale or LAN)
• Tailscale/VPN Mobile Access - Documentation for safely using /mobile away from home through Tailscale or another private VPN without public port forwarding
• Filters — Filter stations by last-heard time, distance, packet type, callsign, source, and direct/via-digipeater RF path
• Solar Data Widget — Live HF propagation summary image (solar flux, K-index, band conditions) from hamqsl.com in the Propagation tab
• Real-time Updates — WebSocket-driven live dashboard
• Connection Status UX - Unified RF/APRS-IS/WebSocket status pills with connected/retrying/disconnected states and a header notification drawer for TCP RF issues and received APRS messages

• Longest Path Leaderboard — Daily ranking of the longest RF paths heard
• Propagation Heatmap — Hour-by-hour visualization of propagation activity over time
• Station Reliability Scoring — Grade (A–F) for each station based on packet consistency
• Best Time of Day — Identify peak propagation windows from historical data
• Sporadic-E Diagnostics — Select 6-hour, 24-hour, or 7-day analysis windows and see RF station counts, strongest stations, qualifying-distance counts, near misses, and path-quality weighting details
• Weather Analytics Dashboard — Pop-out dashboard for current weather, gauges, history, records, forecast, and map context
• DXView Link - Propagation tab link opens VHF DXView centered on the configured station latitude/longitude

• Band Opening Detection — Automatic alerts when propagation thresholds are exceeded
• Watched VHF Paths — Monitor a target station by callsign, grid, or coordinates and alert when direct-heard RF enhancement reaches the target bearing and distance
• Optional Map Visualizations — Independently enable propagation aura, path reveals, map color harmony, condition backdrops, expressive home marker rings, watched-path flow, quiet direct-heard activity moments, and Off/Basic/Enhanced live packet animation with station bursts and directional hop-by-hop flow
• Antenna-Aware Opportunity Scoring — Include local/target antenna height, transmit power, antenna gain, EIRP, and radio-horizon context in watched-path confidence
• Callsign-Assisted Target Builder — Look up station coordinates through Callook, HamDB, QRZ XML, or HamQTH, with worldwide grid/coordinate overrides
• Alert Tuning Helper — Analyze recent RF path history and recommend more selective band-opening thresholds from your local baseline
• Status/DX Reports — Optional compact APRS status beacons with the best direct DX station, bearing, counts, and propagation level
• Dynamic, MHeard, and Weather Alert Beacons — Rotate preset status messages, beacon direct-heard RF stations, or beacon severe weather alert text with preview-before-transmit controls
• Scheduled Bulletins and APRS Objects — Periodically transmit configured BLN bulletins and APRS objects over RF, APRS-IS, or both, with preview and one-shot transmit controls
• Alert Destination Tests — Send preformatted test messages to selected Discord, Email, and SMS destinations from Settings
• Quiet Hours — Configurable quiet time window (HH:MM 24h) to suppress notifications
• Message Notifications — Get notified via Discord/Email/SMS when APRS messages are received
• MQTT Publishing — Publish retained propagation metrics, score/level topics, Home Assistant Discovery sensors and binary sensors, watched callsign entities, status snapshots, typed automation events, and alert events to brokers such as Mosquitto, Home Assistant, Node-RED, or EMQX
• Discord Webhooks — Push notifications to a Discord channel
• Email (SMTP) — Email alerts via any SMTP server
• SMS Gateway — Text alerts via carrier email-to-SMS gateways

• Current Conditions Banner - Live weather banner on the map view (temperature, wind, humidity, pressure, feels-like) powered by Open-Meteo
• WXnow.txt Transmit - Beacon APRS weather packets from a local WXnow.txt file, with weather SSID, RF/APRS-IS routing, optional position, and stale-file cutoff
• WXnow Condition Fallback - Use local WXnow measurements while still querying Open-Meteo for general condition text/icon
• APRS Weather Station Popups - Decode and show human-readable APRS weather station data, including non-timestamped position weather packets
• Metric/Imperial Weather Display - Switch map weather and APRS WX station displays between °F/mph/in and °C/m/s/mm
• US Zip Code & ICAO Location - Set your weather location by entering a US zip code or worldwide ICAO airport code
• Severe Weather Alerts - NWS active alerts displayed as color-coded banners (red for warnings, orange for watches/advisories)
• Configurable Alert Range - Select how far from your location to monitor severe weather banners/beacons in radius mode (default 40 miles)
• NWS Alert Awareness - Current conditions, animated radar overlays, and NWS alert banners/polygons for weather situational awareness
• Weather Radar Overlay - Optional animated radar tiles layered directly on the map with adjustable opacity for fast visual storm tracking
• GOES GLM Lightning Overlay - Optional live NOAA GOES-19 East or GOES-18 West optical-lightning flashes with automatic satellite selection, a bounded rolling memory window, and configurable nearby-lightning alerts
• Remote Awareness Alerts - Give each watched location its own weather- and lightning-alert radius, cooldown, and Discord/email/SMS destinations
• APRS Weather Mesh - Compare nearby APRS weather stations by freshness, measurement completeness, and short-term trends at selectable 50–500 mile ranges
• NOAA Space Weather Context - Show current Kp and NOAA G/R/S scales beside propagation evidence, with optional threshold alerts and explicit evidence-correlation wording
• Optional PSK Reporter Context - Corroborate station-specific 50 MHz+ digital paths on a five-minute, provider-friendly cadence without mixing them into APRS RF scores
• Rotating Club Display - Open a read-only /kiosk view that cycles through live map, propagation, weather, and RF-activity layouts with configurable timing and fullscreen controls
• NWS Alert Polygons - Optional US map overlay for severe weather polygons, with an independent map-only radius (default 80 miles) and per-category filters for warnings, watches, flood, winter, marine, fire/heat, and other alerts
• NWS Zone Geometry Fallback - Watches or zone-based alerts without native polygons can draw affected county/zone geometry when available
• Adaptive Alert Polling - Automatically increases alert checks to a 1-minute cadence when selected trigger events, such as Tornado Watch or Severe Thunderstorm Watch, become active
• Point or County/Zone Scope - Monitor alerts for your exact station point or switch to a county/forecast-zone UGC target for broader warning coverage
• Adaptive Refresh Strategy - Weather condition refresh stays user-configurable while alert polling cadence can increase automatically during elevated severe-weather scenarios

• Send & Receive — Two-way APRS messaging with auto-ACK and retry support
• Click to Reply — Click any received message to auto-populate the TO callsign for quick reply
• Message Log — Filterable message history (All / Sent / Received)
• Message Sort Order — Switch messages between newest-first and oldest-first ordering
• Sibling SSID Inbox Option — Optionally receive messages addressed to the same base callsign with another SSID, such as W1AW-7 while running W1AW-1
• Packet Sort and Digipeat Filter — The Packets tab loads recent packet history, sorts newest or oldest first, and can show packets your station digipeated
• Mobile Message Refresh — Mobile UI includes a manual message refresh button and closer parity with desktop message behavior
• RF + IS Routing — Select RF, APRS-IS, or combined routing for messages

• Web-based Configuration — Edit all settings from the browser (saved to config.toml)
• Category-Based Settings Workspace — Navigate Station, Radio, APRS, Tracking, Propagation, Alerts, Display, and Integrations without scrolling one long page
• Settings Search And Deep Links — Search all controls, retain the selected category, and link directly to routes such as #settings/propagation
• Unsaved Change Guidance — Modified sections pulse yellow, appear in navigation, and clear only after a successful save
• Precise Save Impact — Save confirmation distinguishes settings applied immediately, browser refresh requirements, and full application restart requirements
• Section Reset And Validation Routing — Restore one section to its last saved values and automatically open the category containing an invalid field
• Actionable Setup Checklist — Callsign, location, receive-source, APRS-IS, and save checks link directly to the setting that needs attention
• Operating Mode Presets — Show the preset matching the current form, identify manually combined settings as a custom configuration, or stage receive-only RF, RF plus APRS-IS, receive-only IGate, digipeater, bidirectional IGate, or mobile settings for review before saving
• Contextual Setup Guide — Summarize the active station topology and link directly to the RF/TNC, APRS-IS, IGate, digipeater, GPS-source, and beacon settings relevant to it
• Transmit-Safe Saves — Review newly enabled transmit capabilities before they become operational, export a configuration backup, optionally protect transmit settings, or reload the last saved configuration
• Basic and Advanced Views — Keep routine station, receiver, map, propagation, watched-path, and alert controls visible while optional transmit and integration features stay one click away
• Configuration Readiness — Flag missing identity/location/source settings, APRS-IS login/filter issues, and transmit-capable choices before operation
• Clickable Connection Diagnostics — Select the RF, APRS-IS, or WebSocket header indicator for a plain-language status report and direct settings links
• Actionable Empty States and Cross-Navigation — Empty station, analytics, alert, weather, and watched-path views point to the relevant setup page
• APRS Terminology Help — Explain Direct RF, Regional RF, APRS-IS, IGate, digipeating, watched paths, Maidenhead grids, and passcodes inside the application
• Alert Setup Assistant — A short workflow connects baseline collection, threshold recommendations, notification channels, test alerts, and saving
• Settings Import/Export — Back up or restore config.toml before experimenting with RF, APRS-IS, host, or port settings
• Hot-Reload Settings — Most settings apply immediately without restarting the server
• Preview and Transmit Now — Preview station, WXnow, status, MHeard, dynamic, and weather-alert beacon text before one-shot transmit
• Last Transmitted History — Settings panel shows recent station, WXnow, status, MHeard, and weather-alert transmissions
• Beacon Path Selector — Choose digipeater path for beacons (DIRECT, WIDE1-1, WIDE1-1,WIDE2-1, etc.)
• Minute-based Timers — All timer settings (beacon interval, dedupe, cleanup, cooldown) displayed in minutes for simplicity
• Pick Location on Map — Click the map to set your station coordinates
• GPS Ingestion — Use browser/mobile GPS, own APRS position packets, NMEA serial/TCP/UDP streams, or gpsd to move the map marker or update station coordinates
• Robust NMEA Handling - NMEA serial/TCP/UDP ingestion tolerates chunked GPS streams used by common GPS software and devices
• Smart Beaconing — Optional GPS-speed-aware station beacon intervals for mobile/portable use
• Map Object Creation — Drop APRS objects from the map, choose symbol/comment/routing, and save them into the scheduled object list
• APRS Symbol Picker — Visual icon chooser with both primary and alternate symbol tables
• Callsign + SSID Selector — Uppercase callsign input with SSID dropdown (0–15) and descriptions
• APRS-IS Filter Helpers — Generate fixed r/35/-79/80 or r/35.5/-79.8/80 range filters, or moving/mobile m/80 filters, with support for additional javAPRS filter tokens
• Metric System Option — General unit preference controls distances, weather temperature, wind, and precipitation displays
• Collapsible Sidebar — Toggle button to collapse/expand the sidebar for a larger map view
• Persistent Weather Banner — Weather conditions stay visible on the map unless disabled in settings
• Font Selector — Choose from multiple fonts in Settings for crisp, readable text
• Opening Browser Selector - Choose the browser APRS PropView opens on startup, or select Do not open automatically / launch_browser = "none" for headless/service deployments
• About Tab — Application version, build info, diagnostics, update checks, and attribution
• Help & User Guide — In-app help modal covering every feature, control, and setting
• Installer-Based Updates - Windows setup installs can detect GitHub setup assets, download the newer installer from the About tab, close APRS PropView cleanly, and launch setup while keeping user settings and data intact
• Update Checker - Automatically checks the latest GitHub release, supports disabling checks entirely, hides Windows-only installer actions on Linux/macOS, and lets you control the periodic recheck interval for long-running installs
• Persistent UI State — Map toggles, zoom, position, theme, line time filter, station type filters, callsign labels, auto-fit, and settings complexity are saved to the browser and restored on next launch
• Mobile Packet Motion — The mobile map can show the same Off, Basic, or Enhanced live packet setting as desktop, with a local Motion toggle and reduced-motion support
• Linux/Pi Friendly Configuration — Example config and install guide include multi-port RF, AGWPE TCP, private APRS-IS feeds, scheduled packets, and smart beaconing notes
• Station Cleanup — Automatic pruning of stale stations from memory with real-time UI removal
• Station Blocklist — Ignore one callsign/SSID or every SSID belonging to a base callsign before packets enter station, message, propagation, or history data
• Malformed APRS Position Protection — Reject invalid uncompressed coordinates instead of misinterpreting them as compressed positions and plotting them in the wrong region
• Watched Path Map Toggle — Show or hide watched VHF path lines from the map Line options

• Lossless APRS packet handling across RF and APRS-IS transports (no UTF-8 re-encoding or trailing-space trimming)
• Country-neutral callsign handling with APRS-safe character checks and APRS-IS placeholder protection
• Minimum 10-minute beacon interval enforced per APRS-IS usage policy
• Read-only mode: unverified connections (passcode -1) cannot transmit or gate
• Private/local APRS-IS-style servers that omit banners or logresp can still feed received packets; without verification the connection remains read-only
• RF→IS gating does not deduplicate or suppress traffic except for NOGATE / RFONLY
• IS→RF gated packets do not request further digipeating (no WIDE path)
• IS→RF gated packets use APRS third-party format to avoid loops
• APRS-IS filter token syntax validation
• APRS-IS range filter guidance for fixed and mobile clients
• Policy guidance displayed in the settings UI

All settings are in config.toml and can be edited from the web UI Settings tab.

APRS PropView uses standard Leaflet XYZ tiles. For grid-down or field setups, run a local tile server and point the web map at it:

[web]
map_tile_source = "custom"
map_tile_url = "http://127.0.0.1:8080/tile/{z}/{x}/{y}.png"
map_tile_attribution = "OpenStreetMap contributors"
map_tile_max_zoom = 14

The local server can be backed by downloaded OpenStreetMap data or a prepared tile archive. Keep the max zoom realistic for the area you cache; zoom levels above 14 grow quickly. The tile proxy won't fetch a tile above map_tile_max_zoom (19 for the default OpenStreetMap source), though tiles already in the cache are served at any zoom.

The map's Cache control downloads the currently visible base-map tiles at the current zoom into map_tile_cache/. Cached tiles are served by APRS PropView itself through /api/map-tiles/{z}/{x}/{y}, so already-cached areas remain visible later without internet access.

Use the control while you still have internet connectivity:

1. Pan and zoom to the area you expect to operate in.
2. Click Cache and wait for the button to report Done.
3. Repeat at any zoom levels you need offline; each zoom level is cached separately.

If a tile is already cached, PropView reuses it. If a tile is missing while the upstream tile server is unreachable, the map will show a blank/missing tile for that spot until it can be downloaded later. The cache is preserved by Windows installer upgrades and Linux/Pi service updates.

Offline maps do not provide internet APRS, weather, radar, or other external feeds. NWS alert coverage is US-focused.

pip install pyinstaller
python build_exe.py

This produces dist/APRSPropView.exe — a single portable file. On first run it creates config.toml next to the exe and launches the browser.

Install Inno Setup 6, then build a versioned setup executable:

winget install JRSoftware.InnoSetup
python build_installer.py

This produces dist/APRSPropViewSetup-<version>.exe. The installer defaults to a per-user install under %LOCALAPPDATA%\Programs\APRS PropView, lets users choose a different install folder, creates Start Menu shortcuts, and installs the current APRSPropView.exe.

Installer upgrades replace the application executable and bundled files only. User data such as config.toml, propview.db, map_tile_cache/, and user_audio/ is left in place. Publish both APRSPropView.exe and the setup asset on GitHub releases; assets named like APRSPropViewSetup-<version>.exe are detected by the in-app update checker so users can click Install Update in the About tab. On Linux, Raspberry Pi, and macOS, users still see release notices but installer-based update buttons are hidden because those platforms update from source or platform-specific builds.

Build the local test .app bundle on a macOS machine:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt pyinstaller pillow
python build_macos.py

This produces dist/APRS PropView.app. On first launch, the app stores config.toml, propview.db, map_tile_cache/, and user_audio/ in:

~/Library/Application Support/APRS PropView/

The local .app build is unsigned unless you set MACOS_CODESIGN_IDENTITY before running build_macos.py. Unsigned builds are suitable for local testing, but public macOS releases should be code-signed and notarized.

For a public macOS release, build on macOS, then sign, zip, and notarize the bundle with your Apple Developer credentials. Use the macOS builder script on a Mac or macOS CI.

For Linux executable builds, native modem dependencies, and current platform-specific instructions, use cross-platform setup.