accius / openhamclock

OpenHamClock **A real-time amateur radio dashboard for the modern operator.** OpenHamClock brings DX cluster spots, space weather, propagation predictions, POTA activations, SOTA activations, WWFF activations, WWBOTA activations, PSKReporter, satellite tracking, WSJT-X integration, direct rig control, and more into a single browser-based interface. Run it locally on a Raspberry Pi, on your desktop, or access it from anywhere via a cloud deployment. **🌐 Live Site:** openhamclock.com **📧 Contact:** Chris, K0CJH — chris@cjhlighting.com **☕ Support the Project:** buymeacoffee.com/k0cjh — Running openhamclock.com comes with real hosting costs including network egress, memory, CPU, and the time spent maintaining and improving the project. There is absolutely no obligation to donate — OpenHamClock is and always will be free. But if you find it useful and want to chip in, your donations are greatly appreciated and go directly toward keeping the site running and funding future development. **🔧 Get Involved:** This is an open-source project and the amateur radio community is encouraged to dig into the code, fork it, and build the features you want to see. Whether it's a new panel, a data source integration, or a bug fix — PRs are welcome. See Contributing below. **📝 License:** MIT — See LICENSE --- Quick Start Open http://localhost:3000 in your browser. On first run, the server creates a file from and builds the React frontend automatically. A setup wizard will walk you through entering your callsign and grid locator. In development mode, the frontend runs on port 3000 and proxies API requests to the backend on port 3001. You can also configure your station by editing directly: Restart with after editing to apply changes. For development with hot reload: --- Table of Contents • Dashboard Modules • World Map • DX Cluster • PSKReporter • POTA — Parks on the Air • WWFF — World Wide Flora and Fauna • WWBOTA — World Wide Bunkers on the Air • Space Weather • Solar Panel • Band Conditions • Propagation Predictions • Satellites • Contests • DXpeditions • DX News Ticker • WSJT-X Integration • Weather • DE / DX Location Panels • Header Bar • Analog Clock • Themes and Layouts • Map Layers and Plugins • Languages • Profiles • Auto-Refresh on Update • Health Dashboard • Configuration Reference • Deployment • Local / Desktop • Raspberry Pi • Docker • Railway (Cloud) • DX Spider Proxy • WSJT-X Relay Agent • Updating • Architecture • API Endpoints • Frequently Asked Questions • Contributing • Credits • License --- Dashboard Modules OpenHamClock is built from independent modules, each focused on a specific data source or function. Every module fetches its own data, manages its own refresh cycle, and can be toggled on or off. Below is a detailed walkthrough of each one. --- World Map The central interactive map is the heart of the dashboard. It ties every other module together visually — DX spots, POTA/WWFF/SOTA/WWBOTA activators, satellite orbits, signal paths, and your own station location all appear here. **What it shows:** • **Your station (DE)** — A labeled marker at your configured location with your callsign. • **DX cluster spots** — Colored circle markers for each DX spot, color-coded by band (160m = dark red, 80m = orange, 40m = yellow, 20m = green, 15m = cyan, 10m = magenta, etc.). Click any marker to see the full callsign, frequency, mode, spotter, and DXCC entity. • **Great-circle signal paths** — Lines drawn from your station to each DX spot showing the shortest path on the globe. These are true great-circle paths, not straight lines. • **POTA activators** — Green triangle markers for Parks on the Air activators. Click for park name, reference number, frequency, mode, and spot time. • **WWFF activators** - Light Green inverted triangle markers for World Wide Flora and Fauna activators. Click for park name, reference number, frequency, mode, and spot time. • **SOTA activators** - Orange diamond markers for Summits on the Air activators. Click for summit name, reference number, frequency, mode, and spot time. • **WWBOTA activators** - Light purple square markers for World Wide Bunkers on the Air activators. Click for bunker name, reference numbers, frequency, mode, and spot time. • **Satellite positions** — Colored markers for amateur radio satellites with orbital track lines showing their predicted path. • **PSKReporter paths** — Signal paths from the PSKReporter network showing who is hearing whom on digital modes. • **Day/night terminator** — A shaded overlay showing which parts of the Earth are in darkness, updated in real time. • **Map legend** — Bottom-left corner shows the color key for all band markers plus DE, DX, sun, and moon icons. **How to use it:** • **Pan and zoom:** Click and drag to pan, scroll wheel to zoom. Double-click to zoom in. • **Toggle overlays:** Use the header bar buttons to turn DX Paths, DX Labels, POTA, WWFF, SOTA, WWBOTA, Satellites, PSKReporter, and WSJT-X overlays on and off. Each button shows its current state (highlighted = on). • **Click any marker** to see detailed information in a popup. • **Set a DX target:** Click anywhere on the map to set a DX target location for propagation predictions. The DX panel on the right sidebar updates with the bearing, distance, and grid square of wherever you clicked. **How it works under the hood:** The component uses Leaflet.js for rendering. DX spot coordinates are resolved in order of precision: callsign database lookup → DXCC prefix table → Maidenhead grid square extracted from spot comments. Great-circle paths are calculated using the Haversine formula and rendered as polylines with intermediate waypoints for visual accuracy. The day/night terminator is computed from the current solar declination and hour angle. The map tile style adapts to your selected theme (dark tiles for dark themes, light tiles for light themes). --- DX Cluster Live DX spots streamed from the worldwide DX Spider cluster net…