← retour aux outils back to tools

# Gqrx

Application de réception radio logicielle (SDR) construite sur GNU Radio, utilisée pour la surveillance de spectre et l'analyse de signaux RF. Software-defined radio receiver application built on GNU Radio, used for spectrum monitoring and RF signal analysis.

↗ https://gqrx.dk

## 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

Help / Man page

    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

Aide / Page de manuel

    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