a scanner for gqrx!
Switch branches/tags
Nothing to show
Clone or download



A scanner to interface with GQRX, based on the remote control tool https://github.com/marmelo/gqrx-remote

Simply loops over a list of frequencies in a csv and listens for activity.


Simply import the module, and make a scanner instance:

scanner = gqrx_scan.Scanner(hostname='', port=7356, directory='/', waitTime=8, signalStrength=-12)

These are the default arguments in the constructor, which you can modify as you need. The hostname and port are where the scanner connects to GQRX. The directory is where you've saved a csv file with the frequencies you wish to scan. The waitTime is how long the scanner waits after a signal drops below the threshold before continuing scanning. This is useful if you have dispatch tones before a voice dispatch, for example. The signalStrength field is the strength below which signals are ignored.

Once you have a scanner object, call

scanner.load(freq = 'freq.csv') 

to import the csv into the scanner, and then run


To scan a range of frequencies with a given mode, we can instead use the scan_range method as follows:

scanner.scan_range(minfreq, maxfreq, mode, step=500, save = None)

This loops continuously from minfreq to maxfreq with a step size of step (defaults to 500 Hz) and stops when there is a transmission. In the future I'd like to add a save option to write active frequencies to a file for later review. As an example, we can scan the US FM broadcast band by way of the command

scanner.scan_range(88.0, 108.0, 'WFM_ST', step=100000)

This will loop over the FM broadcast bands and stop on the first active station.

There's a sample csv file for the format the scanner expects. The first column is the frequency, the second is the mode, and the third is an optional tag for the channel.
This is displayed in the terminal, along with the time and frequency, when a transmission occurs.

Make sure you have enabled remote connections in GQRX.

This is still in it's early phases, and there's a lot of cool features to add. If anyone would like to contribute, submit a pull request!


  1. GUI

  2. Ability to add/delete frequencies in the GUI

  3. Set squelch/signalStrength for each channel

  4. Timeout for scan_range (so as not to get stuck on a birdie or a continuous broadcast)

  5. Logging for the scan_range function to find interesting frequencies automatically.

  6. Make a GUI

  7. Interface with automatic recording of a given frequency (or set of freqs) and save the audio and timestamp in a sqlite database