Open-source project
sgoudelis/ground-station avatar
sgoudelis/ground-station

Ground Station: one browser console for orbit tables, rotators and the waterfall

Browser-based ground station suite for satellite tracking, SDR reception, hardware control, and telemetry decoding

4,894 stars847 forksJavaScriptGPL-3.0

At a glance

What is it?
Ground Station puts satellite and celestial tracking, SDR reception and decoding, antenna rotator control and scheduled observations behind a login in one web interface.
Who is it for?
Ground Station fits an amateur radio operator, satellite enthusiast or researcher who wants orbit visualization, multi-target tracking, waterfall decoding and scheduled observations in one web interface, and who accepts a release train that shipped ten point releases between 2026-09-29 and 2026-10-30.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 3 days ago.
What is it written in?
Mainly JavaScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • sgoudelis/ground-station4,894 ★ · +85
Star history
Repository2026-09-232026-11-15
sgoudelis/ground-station4.8k4.9k

85 Stars in the last 53 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

CelesTrak and SatNOGS sit upstream of every target you track

Ground Station brings orbit visualization, multi-target tracking consoles, SDR waterfall analysis, packet and telemetry decoding, scheduled observations, and hardware management into a single web interface. Orbital data management shows up across the recent releases: v0.8.16 expanded satellite catalog management with dedicated orbital-data pages, lifecycle timestamps, improved search, filtering, pagination, and table layouts, and v0.8.21 added TinyGS transmitter data in orbital synchronization. v0.8.24 made saved satellites and transmitters load reliably by NORAD ID despite autocomplete limits.

Skyfield and SGP4 propagation read from stored orbital elements

v0.8.21 added OMM orbit propagation to Earth View and satellite tracking. v0.8.15 added vector coverage details, unified property editing in celestial target context menus, pass pagination that improves as results change, and Earth trajectory caching built on minimal non-dominated projections with duplicate-free canonical target updates. v0.8.16 refined the celestial catalog and Solar System display with clearer object labels and an option to hide labels for unfocused objects, and the Solar System page tracks celestial bodies with live orbital context and interactive visualization.

Each tracker gets its own target-N slot

The Multi-Target Tracking Console view shows an active ISS target with per-target control and live tracking telemetry. The Global Satellite Overview page adds quick group selection and real-time satellite status indicators. Scheduling has its own safeguards: v0.8.24 added scheduler observation conflict detection that validates shared hardware time across the observation form, satellite selector, and pass selector, and v0.8.20 added rig selection and clearer conflict choices to observation scheduling.

IQ samples cross threads and processes, not the browser tab

The browser is the interface for the SDR side. The SDR Waterfall View carries a live transcription overlay during active satellite communication, and a second view shows GMSK being received and decoded with two VFOs. Decoders keep arriving in the release notes: live and scheduled LoRa decoding in v0.8.21, LASARSAT AX.25 beacon decoding in v0.8.22, more robust SSTV decoding with decoded images in a reusable image viewer in v0.8.23, and packet decoding, telemetry parsing and housekeeping views with RS18S support in the USP parser in v0.8.24. v0.8.18 added the ability to join a live SDR stream with independent VFOs.

The image builds headers for radio families the interface does not list

The backend stage is ubuntu:noble-20250925 with a Python 3.12 toolchain, and the apt list is where the hardware story shows itself:

dockerfile
RUN apt-get update && apt-get install -y --no-install-recommends \
    librtlsdr-dev \
    libairspy-dev \
    libairspyhf-dev \
    libhackrf-dev \
    libsamplerate0-dev \
    libfftw3-dev \
    python3.12-venv \
    swig \
    avahi-daemon \
    cmake g++ libpython3-dev python3-numpy

The apt list installs development headers for RTL-SDR, Airspy, Airspy HF and HackRF. The frontend stage is separate and short, and its comment records a real constraint:

dockerfile
FROM node:22-bookworm-slim AS frontend-builder
RUN npm ci --no-audit --no-fund && test -x node_modules/.bin/vite
RUN cp .env.production .env
RUN npm run build

The same comment explains why the builder is Debian based: Alpine Node 22 images can make npm ci terminate with Exit handler never called.

Language and clock both live under one preferences path

Language coverage arrived in stages. v0.8.19 expanded Simplified Chinese coverage across the current interface, made many previously hardcoded labels, prompts, tooltips, and status messages translatable, and added guidance for extending other language packs. v0.8.23 made the monitored satellite dialog fall back to option labels when translations are missing.

Ten point releases in three weeks is the stability signal

The release history is dense. Between v0.8.15 on 2026-09-29 and v0.8.24 on 2026-10-30 there were ten releases, and the three most recent are v0.8.22 on 2026-10-26, v0.8.23 on 2026-10-29 and v0.8.24 on 2026-10-30. What moved is legible: a documented public API with scoped access tokens, live event streams and artifact downloads in v0.8.20, live and scheduled LoRa decoding in v0.8.21, LASARSAT AX.25 beacon decoding in v0.8.22, more robust SSTV decoding in v0.8.23, and scheduler conflict detection in v0.8.24. At that pace, pin the version you validate against.

Account creation is not in the documentation you can see

The screenshot list includes a login screen, described as user authentication before access to the Ground Station interface. v0.8.20 added a documented public API with scoped access tokens and lets Docker deployments configure the Nginx HTTP port with GS_HTTP_PORT, and v0.8.18 added release status and Docker update guidance to Maintenance. The top level of the repository is the map of what exists: backend/, data/, deploy/, docs/, frontend/, scripts/ and tools/, alongside AGENTS.md, DEVELOPMENT.md, CONTRIBUTING.md, CLA.md, SECURITY.md, a .drone.yml and a .pre-commit-config.yaml. Plan on reading docs/ and DEVELOPMENT.md before assuming an install path.

Editorial conclusion

Ground Station fits an amateur radio operator, satellite enthusiast or researcher who wants orbit visualization, multi-target tracking, waterfall decoding and scheduled observations in one web interface, and who accepts a release train that shipped ten point releases between 2026-09-29 and 2026-10-30. Before committing, read docs/ and DEVELOPMENT.md, check that your radio's libraries are among those the Dockerfile installs (RTL-SDR, Airspy, Airspy HF and HackRF headers), and pin the exact version you validate against.

Frequently asked questions

Which SDR hardware does Ground Station manage?

The Dockerfile installs development headers for RTL-SDR, Airspy, Airspy HF and HackRF (librtlsdr-dev, libairspy-dev, libairspyhf-dev and libhackrf-dev) in the backend image.

Where does Ground Station get its satellite orbital data?

Orbital data is handled inside the app: v0.8.16 added dedicated orbital-data pages with lifecycle timestamps, and v0.8.21 brought TinyGS transmitter data into orbital synchronization and OMM orbit propagation to Earth View and satellite tracking.

How does Ground Station track several satellites at once?

The Multi-Target Tracking Console shows an active target with per-target control and live tracking telemetry, and v0.8.24 added scheduler conflict detection that validates shared hardware time across observations.

Which interface languages does Ground Station cover?

v0.8.19 expanded Simplified Chinese coverage across the current interface and made many previously hardcoded labels, prompts, tooltips and status messages translatable, with guidance added for extending other language packs.

Does Ground Station work on a station without outbound internet access?

Some features reach outside services: v0.8.20 added Google Translate and LibreTranslate options for transcription, and v0.8.21 added TinyGS transmitter data in orbital synchronization.

Official sources

  1. Issues
  2. License: GPL-3.0
  3. README
  4. Releases
  5. sgoudelis/ground-station on GitHub
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/sgoudelis-ground-station.svg)](https://hysenlabs.com/projects/sgoudelis-ground-station)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/sgoudelis-ground-station.svg)](https://hysenlabs.com/projects/sgoudelis-ground-station)

Was this useful?