openhamclock/CHANGELOG.md

Changelog

All notable changes to OpenHamClock will be documented in this file.

[3.12.0] - 2025-02-03

Fixed

• PSKReporter MQTT - Fixed critical bug: field mapping used sa/ra (ADIF country codes) instead of sc/rc (callsigns), so no MQTT spots ever matched
• PSKReporter RX topic - Fixed subscription pattern that had one extra wildcard, subscribing to sender locator position instead of receiver callsign
• PSKReporter HTTP fallback - If MQTT fails to connect within 12 seconds, automatically falls back to HTTP API so users always get data
• Map layer persistence - Map style/zoom save was overwriting plugin layer settings (aurora, earthquakes, weather radar). Now merges correctly
• Version consistency - All version numbers now read from package.json as single source of truth. Previously health endpoint said 3.3.0, config said 3.10.0, UI said 3.7.0
• PSKReporter 403 spam - Server now backs off for 30 minutes on 403/429 responses instead of retrying every request

Added

• State persistence - All user preferences now survive page refresh: PSK/WSJT-X panel mode, TX/RX tab, solar image wavelength, weather panel expanded state, temperature unit
• Collapsible weather - DE location weather section collapses to one-line summary, expands for full details
• Lunar phase display - 4th cycling mode in Solar panel shows current moon phase with SVG rendering, illumination %, and next full/new moon dates
• F°/C° toggle - Switch temperature units with localStorage persistence; header always shows both

[3.11.0] - 2025-02-02

Added

• PSKReporter Integration - See where your digital mode signals are being received
  • New PSKReporter panel shows stations hearing you and stations you're hearing
  • Supports FT8, FT4, JS8, and other digital modes
  • Configurable time window (5, 15, 30 min, 1 hour)
  • Shows band, mode, SNR, and age of each report
  • Click on a report to center map on that location

Changed

• Bandwidth Optimization - Reduced network egress by ~85%
  • Added GZIP compression (70-90% smaller responses)
  • Server-side caching for all external API calls
  • Reduced client polling intervals (DX Cluster: 5s→30s, POTA: 60s→120s)
  • Added HTTP Cache-Control headers
  • POTA now uses server proxy instead of direct API calls

Fixed

• Empty ITURHFPROP_URL causing "Only absolute URLs supported" error
• Satellite TLE fetch timeout errors now handled silently
• Reduced console log spam for network errors

[3.10.0] - 2025-02-02

Added

• Environment-based configuration - Station settings now stored in .env file
  • .env is auto-created from .env.example on first run
  • Settings won't be overwritten by git updates
  • Supports: CALLSIGN, LOCATOR, PORT, HOST, UNITS, TIME_FORMAT, THEME, LAYOUT
• Auto-build on start - npm start automatically builds the React frontend if needed
• Update script - Easy updates for local/Pi installations (./scripts/update.sh)
  • Backs up config, pulls latest, rebuilds, preserves settings
• Network access configuration - Set HOST=0.0.0.0 to access from other devices
• Grid locator auto-conversion - Automatically calculates lat/lon from LOCATOR
• Setup wizard - Settings panel auto-opens if CALLSIGN or LOCATOR is missing
• Retro theme - 90s Windows style with teal background and silver panels
• Classic layout - Original HamClock-style with black background, large colored numbers, rainbow frequency bar

Changed

• Configuration priority: localStorage > .env > defaults
• Server startup now shows station callsign and network access info
• Settings panel updated with .env setup instructions
• DX Spider connection uses dxspider.co.uk as primary (thanks Keith G6NHU)
• SSID -56 for OpenHamClock connections (HamClock uses -55)

Fixed

• Header clock "shaking" when digits change - now uses monospace font
• Header layout wrapping on smaller screens - added whiteSpace: nowrap
• Reduced log spam with rate-limited error logging (1 per minute per type)
• DX Spider connection errors silenced for common issues (ECONNRESET, ETIMEDOUT)

[3.9.0] - 2025-01-31

Added

• DX Filter modal with tabs for Zones, Bands, Modes, Watchlist, Exclude
• Spot retention time configurable (5-30 minutes) in Settings
• Satellite tracking with 40+ amateur radio satellites
• Satellite footprints and orbit path visualization
• Map legend showing all 10 HF bands plus DE/DX/Sun/Moon markers

Changed

• Enlarged Header, DE, and DX panels with bigger fonts
• Improved callsign label positioning on map

Fixed

• DX Filter modal crash when opening
• K-Index display showing correct values
• Contest calendar attribution

[3.8.0] - 2025-01-28

Added

• Multiple DX cluster source fallbacks
• ITURHFProp hybrid propagation predictions
• Ionosonde real-time corrections

Changed

• DX cluster cache extended to 90 seconds
• Improved error handling for external APIs

[3.7.0] - 2025-01-25

Added

• Modular React architecture with Vite
• 13 extracted components
• 12 custom data-fetching hooks
• 3 utility modules
• Railway deployment support
• Docker support

Changed

• Complete rewrite from monolithic HTML to modular React
• CSS variables for theming
• Separated concerns for easier contribution

[3.0.0] - 2025-01-15

Added

• Initial modular extraction from monolithic codebase
• React + Vite build system
• Express backend for API proxying
• Three themes: Dark, Light, Legacy

---

Version History

• 3.10.x - Environment configuration, themes, layouts
• 3.9.x - DX filtering, satellites, map improvements
• 3.8.x - Propagation predictions, reliability improvements
• 3.7.x - Modular React architecture
• 3.0.x - Initial modular version
• 2.x - Monolithic HTML version (archived)
• 1.x - Original HamClock fork