GlanceRF

Open-source ham-radio dashboard: clocks, maps, weather, countdowns, and more—arranged in a grid you choose, so the stuff that matters is visible at a glance.

With thanks to Elwood for the original project that inspired this one.

GlanceRF main dashboard example

How do I install?

Download for Windows, run one command for Linux/Mac, or use Docker. Follow the prompts. Done.

Quick & Easy – Get the installer Find on Docker

Features

  • ✓
    Modes — Desktop app or browser. Run locally, or as a service. Read-only port for public displays.
  • ✓
    Layout — Any grid size, any monitor; modules resize to fit. Choose which modules go where and resize or expand cells.
  • ✓
    Example modules — Clocks. Maps with overlays. Weather. RSS. APRS. SOTA/POTA. Full module list

Screenshots

Main dashboard
Main dashboard (click to open)
Setup page 1 – Layout
Setup – Layout (click to open)
Setup page 2 – Station & updates
Setup – Station & updates (click to open)
Layout editor
Layout editor (click to open)
Blank layout editor
Blank layout editor (click to open)
Layout with expanded cell
Layout expanded (click to open)

Documentation

Guides match the repo’s numbered docs. Open the documentation home for what to read first, or browse the Markdown on GitHub.

  • Installation – Windows, Linux, macOS, Docker
  • User guide – Setup, menu, layout, run at logon, daily use
  • Configuration – Config keys, environment variables
  • Modules – Available modules, map overlays
  • Debugging – Log levels, APRS debug, troubleshooting
  • Telemetry – What is collected and how to opt out

Technology

Python 3.8 or higher. FastAPI and WebSockets. Config in glancerf_config.json. Install dependencies with requirements-linux.txt, requirements-mac.txt, requirements-windows.txt, or requirements-windows-desktop.txt (PyQt5/PyQtWebEngine for Windows desktop).

Python FastAPI WebSocket PyQt Uvicorn

Feature requests & Bugs

See Feature requests for the list. Open an Issue on GitHub. No GitHub account? Email [email protected].