SDR++, The bloat-free SDR software
 
 
 
 
 
Go to file
Ryzerth 68fdd7e3f0 Fixed gains 2021-03-07 00:57:08 +01:00
.github yeeted portaudio 2021-02-23 00:26:35 +01:00
airspy_source Support installation via CMake 2021-02-11 22:49:33 +01:00
airspyhf_source Support installation via CMake 2021-02-11 22:49:33 +01:00
audio_sink Added stream name 2021-02-28 16:32:57 +01:00
core Fixed bad argument in compile args 2021-03-01 17:39:39 +01:00
file_source added more options to sdrplay module 2021-02-26 16:52:54 +01:00
hackrf_source Support installation via CMake 2021-02-11 22:49:33 +01:00
plutosdr_source Fixed bug tuning with sdrplay and rtlsdr 2021-02-15 13:18:21 +01:00
radio Fixed some stuff 2021-02-20 15:27:43 +01:00
recorder Added stream name 2021-02-28 16:32:57 +01:00
root New recorder plugin + bugfix 2021-02-06 21:28:27 +01:00
rtl_sdr_source Added offset tuning option to rtl-sdr 2021-02-17 16:00:22 +01:00
rtl_tcp_source Hide antenna select when SDR only has one antenna 2021-02-23 15:15:29 +01:00
rx888_source Support installation via CMake 2021-02-11 22:49:33 +01:00
sdrplay_source Fixed gains 2021-03-07 00:57:08 +01:00
soapy_source Hide antenna select when SDR only has one antenna 2021-02-23 15:15:29 +01:00
spyserver_source Support installation via CMake 2021-02-11 22:49:33 +01:00
src changes to the build system 2020-12-22 14:50:26 +01:00
win32 Push before merge 2020-09-06 15:39:09 +02:00
.gitignore changes to the build system 2020-12-22 14:56:57 +01:00
CMakeLists.txt Merge pull request #75 from aosync/master 2021-02-23 14:55:08 +01:00
cmake_uninstall.cmake Generate a Linux desktop icon 2021-02-12 00:03:30 +01:00
create_root.bat changes to the build system 2020-12-22 14:50:26 +01:00
create_root.sh changes to the build system 2020-12-22 14:50:26 +01:00
license added license 2020-07-20 00:43:36 +02:00
make_debian_package.sh New debian deb build file 2021-02-12 00:15:35 +01:00
make_windows_package.ps1 Added RTL-SDR module by default 2021-02-13 22:48:42 +01:00
readme.md bugfix + added missing contributors 2021-02-28 17:32:22 +01:00
sdrpp.desktop Generate a Linux desktop icon 2021-02-12 00:03:30 +01:00

readme.md

SDR++, The bloat-free SDR software

Screenshot SDR++ is a cross-platform and open source SDR software with the aim of being bloat free and simple to use.

Linux Build

Features

  • Wide hardware support (both through SoapySDR and dedicated modules)
  • SIMD accelerated DSP
  • Cross-platform (Windows, Linux, OSX and BSD)
  • Full waterfall update when possible. Makes browsing signals easier and more pleasant

Comming soon

  • Digital demodulators and decoders
  • Light theme (I know you weirdos exist lol)
  • Waterfall color scheme editor
  • Switchable fft size
  • other small customisation options

Installing

Windows

Download the latest release from the Releases page and extract to the directory of your choice.

To create a desktop short, rightclick the exe and select Send to -> Desktop (create shortcut), then, rename the shortcut on the desktop to whatever you want.

Linux

Download the latest release from the Releases page and extract to the directory of your choice.

Then, run:

sudo apt install libfftw3-dev libglfw3-dev libglew-dev libvolk2-dev libsoapysdr-dev libairspyhf-dev libiio-dev libad9361-dev librtaudio-dev libhackrf-dev
sudo dpkg -i sdrpp_debian_amd64.deb

If libvolk2-dev is not available, use libvolk1-dev.

MacOS

TODO

BSD

TODO

Building on Windows

Install dependencies

  • cmake
  • vcpkg
  • PothosSDR (This will install libraires for most SDRs)
  • rtaudio

After this, install the following depencies using vcpkg:

  • fftw3
  • glfw
  • glew

Building

mkdir build
cd build
cmake .. "-DCMAKE_TOOLCHAIN_FILE=C:/Users/Alex/vcpkg/scripts/buildsystems/vcpkg.cmake" -G "Visual Studio 15 2017 Win64"
cmake --build . --config Release

Create a new root directory

./create_root.bat

Running for development

If you wish to install SDR++, skip to the next step

You will first need to edit the root_dev/config file to point to the modules that were built. Here us a sample if what it would look like:

...
"modules": [
    "./build/radio/Release/radio.dll",
    "./build/recorder/Release/recorder.dll",
    "./build/rtl_tcp_source/Release/rtl_tcp_source.dll",
    "./build/soapy_source/Release/soapy_source.dll",
    "./build/audio_sink/Release/audio_sink.dll"
]
...

You also need to change the location of the resource and module directories, for development, I recommend:

...
"modulesDirectory": "../root_dev/modules",
...
"resourcesDirectory": "../root_dev/res",
...

Remember that these paths will be relative to the run directory.

Off cours, remember to add entries for all modules that were built and that you wish to use.

Next, from the top directory, you can simply run:

./build/Release/sdrpp.exe -r root_dev

Or, if you wish to run from the build directory:

./Release/sdrpp.exe -r ../root_dev

Installing SDR++

If you chose to run SDR++ for development, you do not need this step. First, copy over the exe and DLLs from build/Release/ to root_dev.

Next you need to copy over all the modules that were compiled. To do so, copy the DLL file of the module (located in its build folder given below) to the root_dev/modules directory and other DLLs (that do not have the exact name of the modue) to the root_dev directory.

The modules built will be some of the following (Repeat the instructions above for all you wish to use):

  • build/radio/Release/
  • build/recorder/Release/
  • build/rtl_tcp_source/Release/
  • build/spyserver_source/Release/
  • build/soapy_source/Release/
  • build/airspyhf_source/Release/
  • build/plutosdr_source/Release/
  • build/audio_sink/Release/

Building on Linux / BSD

Install dependencies

  • cmake
  • fftw3
  • glfw
  • glew
  • libvolk

Next install dependencies based on the modules you wish to build:

  • soapy_source: SoapySDR + drivers for each SDRs (see SoapySDR docs)
  • airspyhf_source: libairspyhf
  • plutosdr_source: libiio, libad9361
  • audio_sink: librtaudio-dev

Note: make sure you're using GCC 8 or later as older versions do not have std::filesystem built-in.

Building

replace <N> with the number of threads you wish to use to build

mkdir build
cd build
cmake ..
make -j<N>

Create a new root directory

sh ./create_root.sh

Running for development

If you wish to install SDR++, skip to the next step

First run SDR++ from the build directory to generate a default config file

./sdrpp -r ../root_dev/

Then, you need to edit the root_dev/config file to point to the modules that were built. Here us a sample if what it would look like:

...
"modules": [
    "./build/radio/radio.so",
    "./build/recorder/recorder.so",
    "./build/rtl_tcp_source/rtl_tcp_source.so",
    "./build/soapy_source/soapy_source.so",
    "./build/audio_sink/audio_sink.so"
]
...

Note: You can generate this list automatically by running find . | grep '\.so' | sed 's/^/"/' | sed 's/$/",/' | sed '/sdrpp_core.so/d' in the build directory.

You also need to change the location of the resource and module directories, for development, I recommend:

...
"modulesDirectory": "./root_dev/modules",
...
"resourcesDirectory": "./root_dev/res",
...

Remember that these paths will be relative to the run directory.

Off cours, remember to add entries for all modules that were built and that you wish to use.

Next, from the top directory, you can simply run:

./build/sdrpp -r root_dev

Or, if you wish to run from the build directory, you need to correct directories in config.json, and:

./sdrpp -r ../root_dev

Installing SDR++

Coming soon!

Contributing

Feel free to issue pull request and report bugs via the github issues. I will soon publish a contributing.md listing the code style to use.

Credits

Patrons

Contributors

Libaries used