Linux Installation Step-By-Step

This describes the installation and startup procedure for the Linux/Mono version of QIRX V1.0.0.4. The Linux distribution used is Debian 9 ("Stretch"), 64Bit Version. There are different possibilities how to find out the "Bitness" of your Linux. Here you can find some of the usually applied methods. QIRX currently does no runtime check of the bitness of the system.
The installation procedures described here may be different on other systems.


  • Step 1: Check Mono Availability
    In a console, type mono -V
    The output should look similar like the following:

    In case Mono is not installed, follow the instructions on https://www.mono-project.com/docs/getting-started/install/linux/
  • Step 2: Check the availability of the libfftw3f.so.3.
    In a console, type the following commands
    cd /
    find -name libfftw*
    The output should contain a line similar to:
    The path must be one of the search paths of Linux for "Shared Library" files (.so extension). The filename must be libfftw3.so.3
  • Step 3: Check the availability of the C runtime library libc, by typing
    find -name libc.*
    The output should contain a line similar to:
  • Step 4: In the console, return to your home directory, by typing
    cd ~

QIRX Installation

  • Step 5: Copy the downloaded file QIRX_Linux.zip into your home directory.
  • Step 6: Unzip the downloaded file QIRX_Linux.zip in your home directory. This should create a directory QIRX_Linux with some subdirectories.
  • Step 7: Change the current directory by typing (in your home directory)
    cd QIRX_Linux/QIRX/qirxCommon/Externals
    The contents of this directory should look like

  • Step 8: Copy - with admin rights - the three files with the .so extension into the /lib directory (which is contained in the Linux search path for shared libraries), by typing the following command
    sudo cp *.so /lib

Running QIRX

  • Step 9: Change into the directory to run qirx by typing (case-sensitive)
    cd ~/QIRX_Linux/QIRX/qirx_V1.0.0.4/Release
  • Step 10: Run qirx by typing
    mono qirx.exe
    After responding twice with Ok to have a new qirx.config created, the output should look like:

  • Step 11:Select menu Start, TCP/IP.
    The rtl_tcp should start automatically if present on your machine. This should look like this:

    In case it should not be present on your Linux box, you could also choose it on another machine, Windows or Linux or anything where rtl_tcp may run, by entering the IP address in the Configuration menu. In this case, make sure that on the remote machine the StubForRemoteStart.exe has been started.
    In QIRX, after selection of a service, its GUI should be like this:

  • Step 12: Audio Output
    Make sure that the VLC player is installed on your computer or one of the machines in your local network. Start to listen to the UDP audio streamed by qirx, by typing in a console
    vlc --demux=rawaud --rawaud-channels=2 --rawaud-samplerate=48000 udp://@:8765
    The audio should play.