Quick Startup Guide

• Startup Version 3
• Database Driver Installation (For the DAB Database)
• Startup Version 2.1.1.7
• Startup Version 1.x

Important remark for all users only reading headlines:

If you intend to use the ADS-B decoder to show airplanes on the map, you MUST select a sampling rate of 2000000 in the Settings of that receiver, otherwise the ADS-B will not work! Pre-defined for receiver #2.

Startup Step-By-Step Version 3

As one of its main new features, QIRX V3 allows to run more than one receiver simultaneously. This instruction assumes you wish to run each of its three pre-defined receivers with a RTL-SDR dongle, driven by rtl_tcp.exe via TCP/IP on the localhost.
Remark: You may run these instructions equally well with only one or two instead of three receivers, with any rtl-sdr compatible dongle, or other supported hardware (currently sdrplays RSP devices and Airspy's Airspy Mini and R2 devices). For a different or more advanced setup than the one described here, please refer to the Setup page.

• Step 1: Download QIRX V3, containing a zip file with the Setup_qirx_3.msi inside. Doubleclick on it. In the installer, you might select a directory of your choice to install the necessary executables. QIRX V3 and V2 can exist side-by-side without interference, of course each using its own hardware. To run the V3, it is NOT necessary to first un-install the V2 of QIRX.
• Step 2: During the installation, check "Create Desktop Icon".
  
  
  
  
• Step 3: Make sure that your audio output (speakers or phone jack) is enabled.
• Step 4: Start qirx.exe from your desktop by double-clicking on its icon. If not already existing, the data directory structure has been created in the usual application data folder, like e.g.
  C:\Users\<your user name>\AppData\Local\qirx3\.
  The following should happen: A 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 qirx3.config, this is possible, but not recommended. You will be asked by the installer whether you wish to have your old qirx3.config to be deleted or not. If you decide to NOT have your old config file deleted you must ensure by yourself that possible new configuration entries are present in your new config file as well, to avoid errors and undefined behaviour.
  
  Next a Command-line window should be created (minimized), showing text similar like this, produced by qirx_audio.exe:
  
  This qirx_audio.exe is necessary only for DAB, as it contains the decoder for the AAC-coded sound. If you cannot receive DAB stations or if you are simply not interested in it, you might well close this window. If it remains open, it won't hurt, but be of no use either.
  
  And the QIRX window, looking similar like this:
  
  
  The picture shows how QIRX has been pre-configured for the first use. In this configuration, the following is assumed:
  • All three receivers (possible in this configuration) are visible on the screen. They are numbered 1,2,3, the numbers written at the left side.
  • All three receivers use some RTL-SDR kind of hardware, like one with a R820T tuner, or one with the E4000 tuner for instance. We selected this as default because they are the most widely used ones.
    They all are driven from the rtl_tcp.exe program, having been installed automatically.
    Possible other hardware to be used are the family of sdrplay's devices like the RSP1A, or one of the Airspy devices, like the Airspy Mini. How to configure one of those will be explained in a separate part on this website.
• Step 5: Hardware Setup
  To be able to continue successfully and use three locally connected receivers, you need three hardware devices connected via USB. In case you don't have sufficient USB ports available on your PC, you might use a USB hub.
  A particularly useful hardware for such a multi-RX configuration is the "Kerberos" device available from rtl-sdr.com via Othernet. It contains four R820T2 equipped dongles in one metal case, has a connector for an additional 5V power supply being absolutely necessary for three devices, and a built-in USB hub.
  But please note that QIRX is not able to exploit the coherence features possible with Kerberos. This remains a future project. The next pictue shows my setup, able to drive the configuration shown above:
  
  
  
  Of course, three individually housed hardware devices were possible also, but please provide for sufficient power to the devices, as otherwise strange errors may appear. Therefore the "Kerberos" features a separate Micro USB port for a standard 5V supply, which you MUST use if using Kerberos with more than two devices.
  In my case, the USB output of this hardware is connected to a standard USB 2 input on the notebook PC.
• Step 6: Start it
  To start a receiver, you click on the blue triangle in its top bar. Doing so for Rx1 results in something like the following picture:
  
  
  
  After starting the ADS-B decoder on Rx 2, the following message box pops up:
  
  
  Please don't be confused by this message. Usually you should click "No". It is intended as a warning in cases where you need only one receiver and another instance of rtl_tcp might not have been closed. You might appreciate this message after being more familiar with QIRX.
  The screen will immediately show some entries in the Aircraft table, perhaps similar to the following picture:
  
  
  
  In case you see nothing, either there are no aircraft around (Corona), or something is wrong with your configuration, which should not be the case after a fresh installation.
  
  By scrolling down, the part of Rx #3 becomes visible again, and the DAB receiver can be started. After again having confirmed that you do NOT want to delete the two running instances of rtl_tcp:
  
  
  As this is a lot of information for the small notebook screen, I change to the larger one, and after some rearrangement of the different screen parts I get the following:
  
  
  The map appears after clicking the map symbol on the top bar, the Rx1 shows the FM broadcast station with its spectrum and the waterfall, the Rx2 shows the ADS-B with the Aircraft table, and Rx3 shows the DAB.
  In both Rx2 and Rx3, the "Frontend" part of the GUI showing the spectrum and the waterfall has been collapsed.
• Step 8: Check it
  When you see the above pictures, you know all went well. If not, you might wish to have a look at each of the three instances of rtl_tcp, being minimized in the Windows Start Bar. They should somehow look like in the following pictures.
  
          
  
  Remark: These procedures show an example how to get three receivers running simultaneously, with three different demodulators/decoders.
  However, particularly for aviation enthusiasts, it might not be a too realistic scenario. A more realistic one would have been:
  • Rx1: AM demodulator, for listening to the pilot-ATC communication. But beware! This is not allowed in some countries like the one where I am living. Therefore, the FM broadcast demodulator was chosen for this startup demo.
  • Rx2: ADS-B, as shown.
  • Rx3: A second AM demodulator to listen to another ATC frequency in use.
  How to configure QIRX for other scenarios is described here.
• Finished

---

This describes the startup procedure for the Windows "DAB-Only" version starting with V2 (Database Integration starts with V.2.1.1.2) The Operating System used is Windows 10, 64-Bit. Higher versions should behave in the same or very similar way.

Startup Step-By-Step Version 2.1.1.7 and greater

• Step 1: Download QIRX "DAB-Only" V2.1.1.7, containing a zip file with the Setup_qirx_2.1.1.7.msi inside. Doubleclick on it. In the installer, you might select a directory of your choice to install the necessary executables.
• Step 2: In Windows Explorer, select the directory containing the qirx.exe, as used by the installer.
• 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. If not already existing, the data directory structure is created in the usual application data folder, like e.g.
  C:\Users\<your user name>\AppData\Local\qirx\. The following should happen:

  A 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 possible, but not recommended. In this case you must check and ensure yourself that possible new entries are present in your old config file as well, to avoid errors and undefined behaviour.
  
  Next a Command-line window should be created (minimized), showing text similar like this, produced by qirx_audio.exe:
  
  
  And the QIRX window, looking similar like this:
  
  
  The small red dot indicates your own position (no GNSS) at some arbitarily selected point. You might catch it with the mouse and drag it to your real position on the map. If you happen to have a GNSS sensor connected, the dot will become green as soon as a fix can be achieved and placed at the position of your location.
  Remark: For the map to appear after the very first download, you must have an active internet connection. The tiles of the map are automatically loaded from Openstreetmap, as you work with the map. Successively, the cache builds up, residing (per default) in the subdirectory "MapCache". After some time almost only the cache is used, and the internet almost never needed any more. You are strongly advised to only let the cache grow, not delete it from time to time. This is a policy instruction by Opensteetmap. Please note that the mentioned application subdirectories are not deleted on uninstallating qirx, and as a consequence need not re-built on a new installation.
  Due to policy restrictions on the map server, the loading of the map tiles sometimes is rather slow.

• Step 6: In QIRX, click the small blue triangle on the top row. The command-line window should show text similar to this (Important entry: "client accepted"):

  
  
  The QIRX window, looking similar like this (after some rearrangement of the different window parts):
  
  
  If the selected mux can be decoded, you should see the service list and be able to select a service. The audio should play.
  On the map, icons with the location of the received transmitters should show up, if they are recognized by the TII decoder and contained in the database.
  Remark: The transmitter database provided by the installer might not be the latest one. Thus it is strongly recommended to run a database update after the very first installation. On subsequent installs, the existing database is not overwritten. The database update is started from the "Options" tab. A live connection with an active ensemble is necessary.,

• Finished

What could be done if Step 6 above does not give the desired result.

First of all, you must be sure that the Zadig driver is working properly. As mentioned elsewhere, Zadig is NOT part of the QIRX distribution. However, there are many places in the web describing the installation procedure. Now follow the procedure below and see if it results in success. And - for the following tests - stop your firewall in case you are using one.

• Try all USB ports on your machine. Often not all of them work with Zadig. This might depend on the configuration of the PC. No general rule applies.
• A common problem is the index of the USB port. You might have to select e.g. an index of 1 instead of zero in the "Settings" dialog of QIRX under "Device Index". Give it a try.
• If still no success, set the Device Index back to zero, and in the "Settings" dialog, uncheck "Autostart" and "Autostop". Now start rtl_tcp.exe manually before clicking the blue triangle in QIRX. In this case the rtl_tcp commandline window does not close when not succeeding. I assume here that you know how to start rtl_tcp.exe manually by a double-click in the Windows Explorer. rtl_tcp.exe resides in the same directory where you installed QIRX.
• Look what you observe in the commandline window of rtl_tcp.exe when clicking the blue triangle in QIRX. Take a screenshot.
• Usually one of the described measures results in success. If not, send us an email with a description of your actions and screenshots and we'll try to help you.

---

The following section describes the startup procedure for the Windows version of QIRX V0.9.5 and the "DAB-Only" V1.0.0.4. The Operating System used is Windows 10, 64-Bit. Higher versions (V1.x) should behave in the same or very similar way.