Gpredict

SDR & RF HardwareReady to RunLocation: /usr/bin/gpredict

Command Line Execution

Run this command in the TelcoChisel terminal to launch or execute the tool:

Gpredict Command
gpredict --help

Detailed Technical Overview

Gpredict is a real-time satellite tracking and orbit propagation application utilizing NORAD SGP4/SDP4 models. For telecom security researchers auditing satellite communications and 3GPP Non-Terrestrial Networks (NTN), it predicts orbital passes, calculates real-time Doppler frequency shifts, and controls antenna rotators and SDR receivers.

Configuration & Usage Guide

To initialize and configure Gpredict for telecom security audits, follow these steps:

  1. 1Launch Gpredict from the desktop menu or CLI: gpredict
  2. 2Update NORAD Two-Line Element (TLE) satellite data: Edit -> Update TLE data from network.
  3. 3Configure radio control: Preferences -> Interfaces -> Radios, connecting to GQRX (port 7356) for automated Doppler frequency tuning.

Troubleshooting & Security Audits

Gpredict Audit Warning
Ensure system clock is synchronized via NTP before tracking. A clock offset of even a few seconds will introduce significant satellite pointing and Doppler calculation errors.
VIRTUAL RF LAB

Master Gpredict with Interactive Telecom Labs

Practice deploying Gpredict against live cellular networks, radio interfaces, and mobile cores in TelcoSec Academy's browser-accessible cloud sandboxes.

Interactive Cloud Labs No Hardware Required CTSP Certification
Launch Interactive Labapp.telcosec.net · Instant access

Frequently Asked Questions

How does Gpredict compensate for Doppler shift in SDR captures?

Gpredict connects to GQRX or GNU Radio via TCP rigctld protocol, dynamically steering the receiver frequency as the satellite passes overhead.

Can Gpredict track LEO telecom constellations (Starlink, Iridium)?

Yes, any satellite with published NORAD TLE orbital data can be tracked in real time.

Back to Tools Directory