⚡

Alin Li

🛰️

Ground Station
Satellite Monitoring Suite

A full-featured, open-source software solution for satellite tracking and radio communication. Track spacecraft, control radio equipment, and receive live signals from satellites — all from your browser.

🛰️ Satellite Tracking 📡 SDR Radio 🐳 Docker Ready 🔓 GPL-3.0 License

⭐ View on GitHub 💬 Issues & Discussions

77+

GitHub Stars

2,474

Commits

GPL-3

License

AMD64 + ARM64

Platforms

🌍 What is Ground Station?

Everything you need to monitor satellites — in one open-source package

Ground Station is designed for amateur radio operators, satellite enthusiasts, and researchers. It provides a comprehensive web-based platform for monitoring spacecraft in real-time, controlling SDR radio hardware, decoding radio signals, and automating satellite pass observations — all through a beautiful, responsive interface that works on desktop, tablet, and mobile.

Built with the help of Claude Code and Codex · Created by Efstratios Goudelis (sgoudelis)

✨ Key Features

Packed with everything a satellite enthusiast needs

🌐

Real-Time Tracking

Live satellite position on a world map with orbital parameters, pass predictions, and Doppler shift calculations. See exactly where any satellite is right now.

📡

SDR Radio Integration

Control Software Defined Radio hardware directly. Supports SoapySDR with automatic frequency tuning, Doppler correction, and multiple demodulation modes.

🌊

Waterfall Display

Beautiful real-time waterfall visualization of radio signals. Watch satellite signals appear as they pass overhead, with live transcription overlay.

📦

Packet Decoding

Decode satellite telemetry packets in real-time including GMSK, FSK, and BPSK modes. View decoded data in hex + ASCII side-by-side format.

🤖

Automated Observations

Schedule and execute satellite passes automatically! Set monitoring templates with hardware configs and let the system handle AOS/LOS timing.

📱

Responsive Web Interface

Modern Material-UI interface that works on desktop, tablet, and mobile. Control your entire ground station from anywhere on your network.

🔄

TLE Synchronization

Automatic Two-Line Element data sync to keep satellite orbital data up to date. Supports multiple TLE sources for maximum accuracy.

🎛️

Rotator Control

Antenna rotator integration for automatic satellite tracking. Point your antenna precisely at passing satellites for the best signal reception.

📸 Interface Gallery

A look at the beautiful, modern interface

🌍

Global Satellite Overview

Quick group selection with real-time satellite status indicators and pass times.

📡

Tracking Console

Orbital parameters, pass predictions, and real-time position data for any satellite.

🌊

Waterfall View + Transcription

Live SDR waterfall with real-time transcription overlay during ISS communication.

📊

GMSK Packet Decoding

Live packet decoding with decoded output details shown in real-time.

🔢

Telemetry Hex + ASCII Viewer

Payload bytes in hex with ASCII side-by-side for telemetry analysis.

🚀 How It Works

From install to tracking satellites in minutes

Deploy with Docker

One command to deploy on AMD64 or ARM64 (Raspberry Pi). Docker makes setup instant.

Connect SDR Hardware

Plug in your SDR receiver (RTL-SDR, HackRF, etc.) via USB. Ground Station auto-detects it.

Choose Your Satellites

Browse satellite groups — amateur, weather, ISS, scientific. Pick what to monitor.

Track & Decode!

Watch satellites live on the map, listen to their signals on the waterfall, and decode telemetry packets automatically.

🐳 Docker Quick Start

Deploy in seconds on any Linux machine

🖥️ AMD64 (Desktop / Server)

docker run -d \
  --platform linux/amd64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  --device=/dev/bus/usb \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  ghcr.io/sgoudelis/ground-station:latest

🍓 ARM64 (Raspberry Pi)

docker run -d \
  --platform linux/arm64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  -v /dev:/dev \
  --privileged \
  -v /path/to/data:/app/backend/data \
  -e GS_ENVIRONMENT=production \
  ghcr.io/sgoudelis/ground-station:latest

Then open http://localhost:7000 in your browser to access the web interface.

🛠️ Tech Stack

Built with modern open-source technologies

⚛️ React

🎨 Material-UI

🐍 Python

📡 GNU Radio

🔧 SoapySDR

🐳 Docker

🗄️ SQLite

⏰ APScheduler

🌐 WebSocket

🛰️ TLE/SGP4

📻 RTL-SDR

🔄 CI/CD

🎯 Who Is This For?

Perfect for learners, hobbyists, and researchers

📻

Amateur Radio Operators

Track and communicate with amateur satellites like the ISS, AO-91, and CAS-4 series. Decode APRS, voice, and telemetry.

🎓

Students & Educators

Learn about orbital mechanics, radio signals, and space technology hands-on. Perfect for STEM education and school projects!

🔬

Researchers

Collect satellite telemetry data for research. Automated observations let you build datasets while you sleep.

🌤️

Weather Enthusiasts

Receive weather satellite images from NOAA and Meteor-M satellites. See real weather imagery directly from space!

Ready to Track Satellites? 🚀

Ground Station is free, open-source, and ready to deploy. Join the community and start listening to space today!

⭐ Star on GitHub 🤝 Contribute 📖 Dev Guide