RF Scanner and Exporter for use with Shure Wireless Workbench
Allows wide-band RF scans to be performed by an inexpensive RTL-SDR device. The scan data can then be exported as a CSV file formatted for use in WWB.
The librtlsdr
library is required and must be installed separately.
Installation documentation for various platforms can be found on the osmocom wiki
and in the pyrtlsdr project.
pip install rtlsdr-wwb-scanner
It is recommended however to install into a virtual environment such as virtualenv or Python's built-in venv module.
# Create the environment using the built-in venv module
python3 -m venv /path/to/new/virtual/environment
# Activate it using <virtual-environment-path>/bin/activate
source /path/to/new/virtual/environment/bin/activate
# Install rtlsdr-wwb-scanner and its dependencies in the virtual environment
python -m pip install rtlsdr-wwb-scanner
Note for Windows users: The bin
directory should be replaced with Scripts
making the "activate" command <virtual-environment-path>/Scripts/activate
These packages are required, but should be collected and installed automatically:
After installation, the user interface can be launched by:
wwb_scanner-ui
If a virtual environment was used, it must either be activated (see above) or
the wwb_scanner-ui
script must be executed by its absolute file name:
/path/to/new/virtual/environment/bin/wwb_scanner-ui
Or for Windows:
/path/to/new/virtual/environment/Scripts/wwb_scanner-ui
For convenience, a shortcut may be created to launch the above script directly.