Gqrx

Overview

Gqrx is a graphical SDR receiver — a waterfall/spectrum display paired with demodulators (AM, FM, SSB, CW) — built on top of GNU Radio and GNU Radio’s gr-osmosdr hardware abstraction. It’s the quickest way to point a HackRF, RTL-SDR, Airspy, or USRP at a frequency range and visually identify what’s transmitting before building a dedicated GNU Radio flowgraph or capturing raw IQ for offline decoding.

Common Usage

Launch Gqrx (opens device selection dialog)

gqrx

Launch with a specific saved configuration profile

gqrx -c my_hackrf_profile.conf

Start directly in a given input/output audio mode

gqrx --format=snd

Typical Workflow

1. Select device (e.g. HackRF, RTL-SDR) and sample rate on launch
2. Tune to the frequency of interest (e.g. 433.92 MHz for common ISM remotes)
3. Watch the waterfall for bursts when the target device is triggered
   (button press, sensor event, etc.)
4. Set demodulator mode (AM/FM/Raw) matching the observed modulation
5. Record: File -> Record to capture raw IQ (.raw / .wav) for offline analysis
6. Load the recording into inspectrum or a GNU Radio flowgraph to decode

Recordings default to gqrx_YYYYMMDD_HHMMSS___fc.raw Inspect the raw IQ capture afterwards

inspectrum gqrx_20260810_120000_433920000_2000000_fc.raw

Tips

• Gqrx is receive-only — for transmit/replay use hackrf_transfer or a custom GNU Radio flowgraph
• Bookmark frequently-monitored frequencies (garage remotes, tire sensors, alarm systems) via the bookmarks panel to speed up repeat engagements
• Lower the LNA/VGA gain if the waterfall is saturated (solid color) near a strong nearby transmitter
• Squelch adjustment matters a lot for catching short bursts on the waterfall without clutter

gqrx [options]

  -c, --cfgfile <file>   Use a specific configuration file
  -r, --rec-dir <dir>    Set directory for IQ/audio recordings
  -v, --version           Show version information
  -h, --help              Show help

GUI panels:
  Input Controls    Device, sample rate, gain, frequency correction
  Receiver Options   Demodulator mode, filter bandwidth, squelch
  FFT Settings       Waterfall/spectrum display range and averaging
  Bookmarks           Save and recall frequencies of interest

Vue d’ensemble

Gqrx est un récepteur SDR graphique (un affichage waterfall/spectre couplé à des démodulateurs AM, FM, SSB, CW) construit sur GNU Radio et sa couche d’abstraction matérielle gr-osmosdr. C’est le moyen le plus rapide de pointer un HackRF, RTL-SDR, Airspy ou USRP sur une plage de fréquences pour identifier visuellement ce qui émet, avant de construire un flowgraph GNU Radio dédié ou de capturer de l’IQ brut pour un décodage hors ligne.

Utilisation courante

# Lancer Gqrx (ouvre la boîte de dialogue de sélection du périphérique)
gqrx

# Lancer avec un profil de configuration sauvegardé spécifique
gqrx -c my_hackrf_profile.conf

# Démarrer directement dans un mode audio d'entrée/sortie donné
gqrx --format=snd

Flux de travail typique

1. Sélectionner le périphérique (par ex. HackRF, RTL-SDR) et le taux d'échantillonnage au lancement
2. Se caler sur la fréquence d'intérêt (par ex. 433.92 MHz pour les télécommandes ISM courantes)
3. Observer le waterfall pour repérer des bursts quand le périphérique cible est déclenché
   (appui sur un bouton, événement capteur, etc.)
4. Régler le mode démodulateur (AM/FM/Raw) correspondant à la modulation observée
5. Enregistrer : Fichier -> Enregistrer pour capturer l'IQ brut (.raw / .wav) en vue d'une analyse hors ligne
6. Charger l'enregistrement dans inspectrum ou un flowgraph GNU Radio pour le décoder

Les enregistrements sont nommés par défaut gqrx_YYYYMMDD_HHMMSS___fc.raw. Inspecter ensuite la capture IQ brute

inspectrum gqrx_20260810_120000_433920000_2000000_fc.raw

Conseils

• Gqrx est uniquement en réception : pour l’émission/rejeu, utilisez hackrf_transfer ou un flowgraph GNU Radio personnalisé
• Créez des favoris pour les fréquences fréquemment surveillées (télécommandes de garage, capteurs de pneus, systèmes d’alarme) via le panneau des favoris pour accélérer les missions répétées
• Réduisez le gain LNA/VGA si le waterfall est saturé (couleur pleine) près d’un émetteur puissant à proximité
• Le réglage du squelch compte énormément pour capter de courts bursts sur le waterfall sans encombrement

gqrx [options]

  -c, --cfgfile <file>   Use a specific configuration file
  -r, --rec-dir <dir>    Set directory for IQ/audio recordings
  -v, --version           Show version information
  -h, --help              Show help

GUI panels:
  Input Controls    Device, sample rate, gain, frequency correction
  Receiver Options   Demodulator mode, filter bandwidth, squelch
  FFT Settings       Waterfall/spectrum display range and averaging
  Bookmarks           Save and recall frequencies of interest