gnss-sdr(1)

💖 gnss-sdr(1) — the GNSS Software Defined Receiver, bestie edition 💖

okay so. welcome to the gnss-sdr manual page, and yes it's a man page which is giving very "old-school terminal chic" but honestly? iconic. this is section 1, so it's a user command, and it's literally the whole receiver. let's get into it 🛰️✨

---

🌸 NAME 🌸

gnss-sdr — GNSS Software Defined Receiver. she receives. she defines. she's software. periodt 💅

---

🎀 SYNOPSIS 🎀

gnss-sdr -c=<path-to-configuration-file> [OPTION]...

---

🦋 DESCRIPTION 🦋

gnss-sdr is a Global Navigation Satellite Systems Software Defined Receiver written in C++. no cap, she implements the entire signal processing chain — she takes raw samples coming out of an Analog-to-Digital Converter as input, and she processes them all the way up to computing the Position-Velocity-Time solution. and that includes generating code and phase measurements. the whole glow-up, start to finish 💖

she can work with raw data files, OR — if you've got enough computational power to spare — in real time with suitable radio frequency front-ends. the entire receiver is defined in a single configuration file, which means users can define theirs. your receiver, your rules, your main character energy 👑

there's also some flexibility in how flags may be specified. these four examples are all equivalent, so pick whichever one matches your vibe:

gnss-sdr -c=/home/user/rx.conf

gnss-sdr --c=/home/user/rx.conf

gnss-sdr -c /home/user/rx.conf

gnss-sdr --c /home/user/rx.conf

---

✨ OPTIONS ✨

gnss-sdr takes the following options:

• -c=<path-to-configuration-file> or -config_file=<path-to-configuration-file> — sets the configuration file. this flag is mandatory, bestie. you don't skip it. it's not optional, it's the whole point 🫶
• -s=<path-to-raw-signal-file> or -signal_source=<path-to-raw-signal-file> — if defined, this is the path to the file containing the signal samples. it overrides the data file specified in the configuration file 💫
• -log_dir=<path-to-directory> — if defined, overrides the default directory where logs are saved.
• -doppler_max=<doppler_max> — if defined, sets the maximum Doppler value in the search grid, in Hz. overrides the configuration file.
• -doppler_step=<doppler_step> — if defined, sets the frequency step in the search grid, in Hz. overrides the configuration file.
• -cn0_samples=<samples> — number of correlators outputs (one per integration time) used for CN0 estimation. defaults to 20 outputs.
• -cn0_min=<cn0_min> — minimum valid CN0, in dB-Hz. defaults to 25 dB-Hz. if set, it overrides the configuration file.
• -max_lock_fail=<max_lock_fail> — maximum number of lock failures before dropping a satellite 😭 defaults to 50 failures. if set, it overrides the configuration file.
• -carrier_lock_th=<carrier_lock_th> — carrier lock error threshold, in rad. defaults to 0.85 rad (which is 48.7 degrees). if set, it overrides the configuration file.
• -dll_bw_hz=<dll_bw_hz> — if defined, the bandwidth of the DLL low pass filter, in Hz. overrides the configuration file.
• -pll_bw_hz=<pll_bw_hz> — if defined, the bandwidth of the PLL low pass filter, in Hz. overrides the configuration file.
• -RINEX_version=<version> — if defined, specifies the RINEX version (2.11 or 3.02). default: "3.02". overrides the configuration file.
• -version — print program version and exit. short and sweet ⭐
• -help — print all the available commandline flags and exit. your little cheat sheet 🎀

---

🌈 SEE ALSO 🌈

• volk_gnsssdr_profile(1)

examples of configuration files are available at ${prefix}/share/gnss-sdr/conf, where ${prefix} uses to be /usr or /usr/local. iykyk 📂

check <https://gnss-sdr.org> for more information ✨

---

💀 BUGS 💀

please report bugs at <https://github.com/gnss-sdr/gnss-sdr/issues> — the devs want to hear about it, fr fr 🙈

---

👑 AUTHOR 👑

Carles Fernandez-Prades (carles.fernandez@cttc.es)

this software package has been developed at CTTC (Centre Tecnologic de Telecomunicacions de Catalunya, <https://www.cttc.cat>) with contributions from around the world 🌍🫶

---

and that's the whole page, bestie!! version 0.0.21, dated 14 Apr 2026 — go catch some satellites, you've got this 💖🛰️✨ periodt.