Quick Startup (Windows)

This describes the startup procedure for the Windows version of QIRX V0.9.5. The Operating System used is Windows 10, 64-Bit.

Startup Step-By-Step

  • Step 1: Download the Binary. Unpack into an arbitrary - writeable - directory on your machine. "Writeable" is important because the qirx.config file is written during program run and on termination. In case you want to have the software in the usual protected "Program Files" directory structure, you must ensure that qirx.config can be written by the software, by applying suitable security properties. Other files are not modified.

    In case you do NOT want to build from the sources, continue now directly with Step 2. Otherwise, continue with the rest of Step 1 here.
    To build one of the two possible versions, you should first build the qirx_Common Solution, to be found in the qirx_Common subdirectory. After having loaded the solution into Visual Studio 2015, first change in Visual Studio to Release Mode. Debug Mode might be not fast enough to run the software, and is not intended to build and run the software. However, debugging should be possible in Release mode as well. For the subsequent builds of the versions 0.9.5 or, the relative directory structure with respect to qirx_Common should be maintained. Otherwise, the dll references might not be resolved properly.
    To debug, please rename the dll dabTII.dll to e.g. dabTII.dll.sav or something similar. This dll will possibly inhibit the debugging when present during debugging, due to the applied obfuscation of this dll. Without debugger, it should work in the normal way. The software should run also without this dll.
  • Step 2: In Windows Explorer, select the directory containing the qirx.exe of Version 0.9.5 you are going to run. You find it together with all necessary DLLs in [Your base directory]\V0.9.5_qirx\Release. Of course, the qirx.exe of the Version can also be used, but it behaves slightly different (rtl_tcp.exe command line window showing up at a later time).
  • Step 3: Make sure that your audio output (speakers or phone jack) is enabled.
  • Step 4: Make sure that your RTL-SDR compatible dongle is plugged-in.
  • Step 5: In Windows Explorer, start qirx.exe by double-clicking it. The following should happen:
    An "Error" message box, informing about a missing configuration file. At this point, this is normal behaviour, because the config file is - per default - not distributed. Click OK.

    Another message box, asking if the missing config file is to be created. Click Yes.

    In case you want to continue to work with your old qirx.config, this is well possible. You must ensure, however, that possible new entries are present in your old config file as well, to avoid errors and exceptions. To compare, you could use the excellent WinMerge software. Another possibility (xml human friendly) would be using the XMLNotepad editor.

    Next a Command-line window should show up, showing text similar like this, produced by rtl_tcp.exe:

    The QIRX window, looking similar like this:

  • Step 6: In QIRX, select the menu item “Start”, “TCP/IP”. The command-line window should show text similar to this (Important entry: "client accepted"):

    The QIRX window, looking similar like this:

  • Finished

In case you have difficulties performing the steps without errors, please consult the "Troubleshooting" section in the pdf-Version of this guide, contained in the documentation, or download it directly here.