Settings Tab

This is the Settings Tab:

settings tab of wfview
This is the settings tab of wfview.

From the settings tab, numerous program and radio settings may be adjusted.

Radio Connection Settings:

These controls are for the user to select and connect to the radio. When changing these controls, make sure to press “Save Settings” to save the settings for next time. Also, if a different rig is being selected after connecting to a rig, save the settings and re-launch wfview.

Serial Connections:

If an Icom is connected with a USB cable, wfview will generally find and use this connection automatically, without any intervention from the user. If you are having difficulty getting a USB connection to work, you may need to change port permissions. We have a section of the users guide for this, but to temporary try changing permissions, use the following command:

sudo chown $USER /dev/ttyUSB*

The serial device may also be specified using the Serial Device combo box. “Auto” is for automatic detection. wfview automatically populates this list with normal serial devices. If you are using a pseudo-terminal (such as from socat), you may select “Manual…” and enter in the serial port desired. Be sure and press “Save Settings” if you use this feature. And note that you may edit the serial port manually in the preference file, as detailed in the preferences section of this manual.

Network Connections:

To connect to a radio over WiFi or Ethernet, click on the “Enable LAN” radio button. This button also enables the text boxes so that radio information may be entered. You will need to supply the radio’s IP address (or hostname), Radio Control Port (the default is 50001), Username, and Password. These settings are defined at the physical radio. Also be sure to enable network control. Once filled in, press “Connect”. If successful, don’t forget to press “Save Settings”.

  • Connect/Disconnect: This button causes the connection to be made to the rig, or, for the existing connection to drop.
  • Server Setup: This button enables a built-in CI-V server. Use this feature to take a radio without an OEM network connection and “serve” it to the network. This button is intended for use with the IC-7300, but may be used on any CI-V radio. Once the server is running, you can launch a separate instance of wfview on another computer and connect to the radio. Remote audio support is planned.
  • RX Latency (ms): Adjusts the buffer size for the receive audio. If you encounter hiccups in the receive audio, you may want to increase this value. For lower latency, such as an at-home ethernet connection, lower values may be used. The default is 150ms.
  • TX Latency (ms): This is an adjustment for the transmit audio buffer. Longer values are needed for lower-quality connections. The default is 150ms.
  • RX Codec: Select the encoding method for the receive audio. LDPCM is generally preferred, but uses more bandwidth. uLaw also produces acceptable results.
  • TX Codec: Same as above.
  • Sample Rate: This is the sample rate applied to both transmit and receive audio streams. 48k is the default.
  • Audio Output: Use this control to select the audio output device for your system. Linux users may see several devices here. wfview attempts to select the “default” system device on startup, and that should generally be used if at all possible. Using the system’s control panels to select and test the default device (for example, a USB headset), prior to the launching of wfview, is strongly advised.
  • Audio Input: Same as above but for the transmit audio source.


Use these controls to manually toggle the PTT (transmit) on and off. The “Enable PTT Controls” checkbox must be checked in order to send transmit commands. Note that this control does not lock out the transmit button on the radio (although that can be done from the physical radio’s settings). wfview also has an automatic five minute transmit timeout.

Appearance and Behavior Settings:

  • “Draw Peaks” enables a backdrop on the spectrum plot, which holds the maximum value for each frequency. The peak data is cleared upon changing the scope bounds or pressing the “Clear Peaks” button.
  • “Waterfall Dark Theme” toggles between a bright theme and a dark theme for the waterfall and spectrum plot. The colors can be adjusted by editing the preference file. This is detailed more in the preferences section of the manual.
  • “Use System Theme” toggles between a built-in theme (qdarkstyle) and the operating system’s supplied theme. For linux users, the operating system theme can usually be adjusted using your system preferences. The built-in theme may be customized by editing the installed stylesheet (linux only) or specifying a custom stylesheet in the user preference file.
  • “Show full screen” toggles between windowed and full screen mode. Pressing F11 also toggles this state.
  • “When tuning, set lower digits to zero”: This checkbox causes the frequency to round to the selected tuning step. It also applies for double-clicking in the waterfall.


Modulation (mic):

These two combo menus allow the user to select the modulation (transmit audio) source, for both normal and data modes. For remote operation using the OEM network connection, select “LAN” for both. For rigs using a USB connection where the audio is being served using the wfview server, select USB. The modulation level for the selected source can be adjusted on the View tab, and will be labeled with the same name as the source.

Calibration (Reference):

Adjust Reference (IC-9700 only): This button brings up the Adjust Reference dialog box. From this box, the radio’s internal reference may be adjusted. Unlike the radio’s user interface, this allows you to view the waterfall display while making adjustments to the reference. Calibrating the radio to a known-good source on the air, such as a beacon, is a snap.

Reference Adjustment window
IC-9700 Reference Adjustment


To adjust the reference, tune into a known-good station or connect appropriate test signal generation equipment. Now press “Read Current Rig Calibration”. wfview will read the radio’s current settings and update the UI controls. From here, it is recommended to switch to the View tab of wfview. You can now drag the Course and Fine adjustments and see the spectrum change. For best results, begin with the “Center” spectrum mode. Bring wfview in to the 5 KHz span. Be mindful of the mode selected. In sideband mode, the IC-9700 will center the display at the passband center. In wfview, the spectrum’s axis always indicate real frequency, so use this as a guide. Once zoomed in, press “ToFixed” to fix the spectrum bounds. Now adjust the Course reference until the test signal’s waterfall mark lands on the prescribed frequency.


Save Settings: Press this button to save the current wfview configuration to the settings file. Attributes saved include:

  1. Radio connection type and interface
  2. Appearance settings
  3. Window size
  4. Full screen status
  5. waterfall and spectrum plot divider position
  6. Frequency memories

The preferences are stored plaintext, and contain many other useful things, as is explained in the preferences page.

About: Shows the about dialog box, including program build date and version

Exit Program: Closes the program

Debug (debug builds only): Runs debug functions. This button is disabled on release builds.

Satellite Ops: Incomplete feature to facilitate satellite operation on the IC-9700. This button is disabled on release builds.