Skip to content

Latest commit

 

History

History
115 lines (79 loc) · 3.41 KB

README.md

File metadata and controls

115 lines (79 loc) · 3.41 KB

This fork is now abandoned in favor of https://github.com/Marzona/rig-remote

gqrx-remote

Fork of (https://github.com/marmelo/gqrx-remote)

Remotely control gqrx while keeping your bookmarks in order. Interacts with gqrx using the rigctl protocol (which is partially implemented since gqrx v2.3).

gqrx-remote-linux

Features

  • Bookmark frequencies and modes
  • Create bookmarks from the current gqrx frequency and mode
  • Restore gqrx frequency and mode (bookmark double-click)
  • Keep window always on top
  • Auto save configuration on exit
  • scan for activity between bookmarks
  • scan for activity in a frequency range
  • auto bookmark frequencies that are discovered as active

Suggestions are welcome! Check the issues page for the current things I'm working on.

Requirements

  • Gqrx 2.3 (or higher)

Note: The latest official gqrx release is 2.2. You may need to compile gqrx straight from the source.

Usage

You just need to download and run gqrx-remote.py.

For instance, using Linux / Mac OS X, you may do:

$ git clone https://github.com/marmelo/gqrx-remote.git
$ cd gqrx-remote
$ chmod +x gqrx-remote.py
$ ./gqrx-remote.py

$ # if your system is not yet using Python 3.x by default
$ python gqrx-remote.py

If you are using Windows you just need to double-click the gqrx-remote.py file (as the .py file type is most likely already bound with python executable). If you want to get rid of the anoying command-line that is always running in background you may rename gqrx-remote.py to gqrx-remote.pyw and Windows will use the pythonw executable instead (which does not need the command-line).

Screenshots

This software is built using Python default GUI -- Tkinter with Ttk -- which allows us to have an almost-native cross-platform look and feel while using the same code.

Linux

gqrx-remote-linux

Bookmark Database

This software consists of resources files and the code. The resource files are the following:

  • gqrx-remote.conf : the gqrx-remote configuration file
  • gqrx-bookmarks.csv : the bookmark file

The file gqrx-bookmarks.csv consists on a standard comma-separated values file. For reference, the following example file is provided:

79200000,FM,Voice
80425000,FM,Data
82275000,FM,Taxi
97400000,WFM_ST,Radio
118100000,AM,Airport
124150000,AM,Weather
137500000,FM,NOAA
144800000,FM,APRS
162000000,FM,Navy
162025000,FM,Navy Data
165000000,FM,Taxi
442036000,FM,Digital
1090000000,FM,ADBS

The file gqrx-remote.conf is a simple key=value file that stores the configuration of the tool and the UI. Here is an example:

range_min=24
delay=6
always_on_top=false
port=7356
interval=15
range_max=1800
auto_bookmark=false
save_exit=false
sgn_level=25
hostname=127.0.0.1

All the code is organized in:

  • gqrx-remote.py : the main python code for executing the tool
  • a "modules" folder : contains all the python modules with the code
  • a "test" folder : the code in this folder is used for testing (unit tests only)