How do I install?

Download for Windows.
Run one command for Linux/Mac.
Follow the prompts.
Done.

Windows

Download the installer and double-click to run.

Download GlanceRF for Windows

Linux

Open a terminal and run this command:

curl -sSL https://glancerf.zl4st.com/installers/GlanceRF-install-Linux.sh | bash

macOS

Open Terminal (Applications → Utilities) and run this command:

curl -sSL https://glancerf.zl4st.com/installers/GlanceRF-install-Mac.sh | bash

Docker

Run the image from Docker Hub:

docker run -p 8080:8080 pomtom44/glancerf

Then open http://localhost:8080.

Full guides

Method 1 — Quick Installer

Same as the quick steps above: small download, then it pulls the latest code and runs the full installer. Windows: run the .exe. Linux / macOS: paste the curl … | bash line into a terminal. You do not need the GitHub ZIP.

Method 2 — Download from Github and run the installer

Download the repo, extract, then run a script from Project/installers.

Download latest (ZIP)

  • Windows: installers\install-windows.bat
  • Linux: in the Project folder, chmod +x installers/install-linux.sh then ./installers/install-linux.sh (detects desktop vs SSH, distro, and Python).
  • macOS: in the Project folder, chmod +x installers/install-mac.sh then ./installers/install-mac.sh.

The installer sets up Python and dependencies, then asks how you want to run GlanceRF (desktop, browser+terminal, terminal only, or service—options depend on OS and whether you are on a desktop or SSH session).

Method 3 — Docker

Image on Docker Hub. Same minimal command as the Docker box above:

docker run -p 8080:8080 pomtom44/glancerf

Then open http://localhost:8080 (headless server). Volumes, compose, and persistence: Docker guide.

Method 4 — Fully Manual Install

If you prefer not to use the installer, or the installer did not work, follow these steps from the Project folder.

  1. Install Python 3.8 or higher if needed — from python.org (Windows: tick "Add Python to PATH") or your system package manager (Linux/Mac). Check with python --version or py -3 --version on Windows.
  2. Decide desktop or headless — Desktop (Windows): use requirements-windows-desktop.txt; GlanceRF opens in its own window. Headless: use requirements-windows.txt (Windows), requirements-linux.txt (Linux), or requirements-mac.txt (macOS); no window; use a browser. For headless, edit glancerf_config.json and set "desktop_mode": "headless" or "browser".
  3. Install dependencies — pip install -r requirements/requirements-linux.txt (Linux), requirements-mac.txt (macOS), or requirements-windows.txt / requirements-windows-desktop.txt (Windows).
  4. Run GlanceRF — python run.py (or py -3 run.py on Windows). Then use Setup and Layout in the browser (see Configure your dashboard above).