VKVVKVSKIMMER
Support

DOCUMENTATION · VERSION 1.5.18

Set it up,
step by step.

Installation, the GUI, RUN mode, the telnet cluster, N1MM+ and the RBN Aggregator. The same guide, with more detail and the full list of settings, is available as a PDF.

1. What you get

VKVSkimmer is distributed as two independent Windows programs: VKVSkimmer_CW.exe and VKVSkimmer_RTTY.exe. Each has its own decoder chain, its own INI file and its own ports, and you can run one or both. The browser GUI, the telnet cluster and the integrations are the same, so everything in this guide applies to both.

CW skimmerRTTY skimmer
ProgramVKVSkimmer_CW.exeVKVSkimmer_RTTY.exe
Start with logs (optional)VKVSkimmer_CW_with_logs.batVKVSkimmer_RTTY_with_logs.bat
Settings fileskimmer.inirtty.ini
Browser GUIhttp://127.0.0.1:8073/http://127.0.0.1:8074/
Telnet cluster (spots)port 7300port 7301
Telnet HEARD streamport 7310port 7311
RBN Aggregator portoff (rbn_port = 0)off (rbn_port = 0)

The GUI opens by itself in your default browser when the program starts. Public releases are free: no licence file, no expiry.

The browser GUI: band and view controls at the top, spectrum with spot labels, waterfall, live decoder at the bottom, Spots / Signals / Log / Settings on the right.

2. Installation

  1. Unzip the whole package into one folder, for example C:\VKVSkimmer. Keep every file and the models folder next to the programs.
  2. Install the software for your input source (below). Only for the input you use.
  3. Open skimmer.ini (CW) and/or rtty.ini (RTTY) and write your callsign: callsign = F5VKV. You can also do it later in the GUI.
  4. Start VKVSkimmer_CW.exe or VKVSkimmer_RTTY.exe. The GUI opens in the browser. To produce logs (for example to report a problem), start VKVSkimmer_CW_with_logs.bat or VKVSkimmer_RTTY_with_logs.bat instead.

Requirements: Windows 64-bit and a modern browser (Edge, Chrome or Firefox). An internet connection is recommended for the daily MASTER.SCP / cty.dat updates and for RBN Reference; the skimmer works without it.

Icom IC-7610 / IC-7760 - direct I/Q

VKVSkimmer reads the I/Q directly from the radio's USB 3 I/Q port, in 64-bit: no 32-bit Icom ExtIO driver, no HDSDR, no virtual audio cables.

  • IC-7610: firmware 1.20 or later (needed for the I/Q output).
  • From the Icom download page of your radio install the USB I/Q Package for HDSDR: it installs the driver of the [USB 2] I/Q port. HDSDR itself is not needed.
  • Connect the radio's [USB 2] port to a USB 3.0 port of the PC with a real USB 3.0 cable.
  • FTD3XX.dll is included: keep it next to the programs.
  • CI-V runs over the same USB I/Q interface: the radio's other USB / COM CI-V port stays free for your logger.

SDRplay RSP

  • Install the SDRplay Hardware API 3.x for Windows from sdrplay.com. It installs sdrplay_api.dll and the SDRplay API service, which must be running.
  • Supported: RSP1, RSP1A, RSP1B, RSP2, RSPdx, RSPduo (single tuner).
  • Close SDRuno, SDRconnect or any other program that uses the RSP before starting the skimmer.

RTL-SDR dongle

  • Download the RTL-SDR Blog Windows release (Release.zip) from github.com/rtlsdrblog/rtl-sdr-blog/releases and copy rtl_tcp.exe and the DLL files of its x64 folder next to the programs. The skimmer starts and stops rtl_tcp by itself.
  • Install the WinUSB driver with Zadig (zadig.akeo.ie): run it as administrator, Options > List All Devices, select Bulk-In, Interface (Interface 0), WinUSB, Replace Driver.
  • On HF with an RTL-SDR Blog V3 the skimmer uses direct sampling (Q branch) by itself (rtl_direct = auto).
  • Close SDR#, SDR++ or any other program that uses the dongle before starting the skimmer.

Sound card

No extra software: receiver audio of any radio, I/Q from an SDR on a sound card input, or the IF output of an Icom radio (USB audio codec, about 15 kHz).

3. First start: callsign and input source

Open the Settings tab on the right of the GUI. Each block has a badge: live = applied at once; restart = saved to the INI file, applied at the next start.

Settings: input source, spectrum output for the logger, CPU profiles, diagnostics and your callsign.

Your callsign

Settings > Your station > Your callsign (live). It is the spotter of every line (DX de F5VKV-#), the telnet greeting, the RBN Aggregator banner and the RBN login.

REQUIREDWithout a valid callsign the skimmer decodes and shows the stations in the GUI, but publishes nothing: no telnet, no HEARD stream, no RBN Aggregator. A red SET YOUR CALLSIGN warning appears in the top bar.

Portable calls are accepted with a real operating prefix (F/F5VKV, checked against cty.dat) or a suffix (F5VKV/P).

Input source

Settings > Input source, choose the source, Save input, then restart the program. The line in use now shows what the program is actually using.

The input sources.
SourceINI valueNotes
Icom IC-7610 / IC-7760 (direct USB I/Q)input = icomWhole I/Q band, CI-V tuning, MAIN/SUB, RUN mode, TX protection
Sound card - receiver audio (any radio)input = sound_audioAudio of the receiver; set sound_rf_khz to the dial frequency
Sound card - I/Q (SDR, I/Q output)input = sound_iqI/Q of an SDR on a stereo input
Icom IF output (USB audio codec)input = sound_ifAbout 15 kHz around the dial
RTL-SDR dongleinput = rtlsdrThrough rtl_tcp (RTL-SDR Blog release)
SDRplay RSPinput = sdrplaySDRplay API 3

CPU profile (CW)

Settings > Profiles (restart): AUTO (recommended: adapts the decoding effort to the CPU load), LIGHT (older or low-power PCs), MAXIMUM (powerful PCs). The Diagnostics block shows the signal rate, lost data and the analysis time per step: if Lost data is not none, choose LIGHT.

4. The GUI

AreaWhat it does
Top barYour call, input source, decoder mode, I/Q rate, analysis time, number of spots and telnet clients, spot beep, UTC clock
Fit / + / - / Whole IQZoom on the analysed segments, zoom in and out, or show the whole I/Q band of the source
Segment buttonsJump to one analysed segment (e.g. 14000-14018)
Band / ReceiverBand buttons (the radio follows), MAIN / SUB receiver of the Icom
Tune / modeFrequency of the receiver you listen to and its mode: CW, RTTY, USB, LSB, AM, FM
MUTED / vol / pitch / filterAudio in the browser: mute, volume, CW pitch, filter width; tune radio: a click also moves the radio
Show chipsCQ, TEST, UP, QSO: what is drawn on the spectrum. All / Runners: quick filters
RUN OFF / ON, window, CALLERSRUN mode (chapter 5)
labels / keptFull or compact labels; how long a spot stays on screen
Waterfall ON, history, floor, range, PauseWaterfall on/off (off = less CPU in the browser), its length and its colours
Spots / Signals / LogPublished spots, every signal being decoded, messages of the program
Decoder (bottom)Real-time decoder of the station you listen to

Labels: green CQ, orange TEST, violet UP. A grey label with a ? is a call read but not (yet) published: the skimmer is not sure enough. Click a label or a spot to listen to the station (and to tune the radio with tune radio).

Whole I/Q: listen anywhere in the band

Whole IQ shows everything the source delivers (about 1.9 MHz with the Icom). Click any signal to listen to it in the browser, in CW, RTTY, USB, LSB, AM or FM, with the filter width you choose. The decoders keep working on the analysed segments whatever you listen to.

Whole IQ: the full bandwidth of the source; the mode menu lets you listen in CW, RTTY, USB, LSB, AM or FM.

Bands

The analysed ranges are in the [bands] section of the INI file (for example 20m = 14000-14070; several ranges with commas; off = not analysed). Changes from the GUI are applied live. VKVSkimmer_CW_with_logs.bat contest uses the wider [bands.contest] table instead.

5. RUN mode

RUN mode is for when you are running (calling CQ): the skimmer shows the stations that call you around your frequency, a few seconds after they call.

RUN mode: CALLER labels around the run frequency; dashed italic labels are callers read once (provisional). RX and TX markers show the receive and transmit frequencies.
  1. Tune the radio (MAIN) to your run frequency.
  2. Click RUN OFF in the Show row: it becomes RUN ON. The RUN window follows the radio.
  3. Choose UP or DOWN and the window width: 0 = simplex (+/- 500 Hz), up to 15 kHz for split operation.
  4. The spectrum now shows only the stations calling you (CALLER); the list shows callers and runners (CALLERS+RUN). The CALLERS buttons toggle these views.
  5. Click a caller: the SUB receiver is tuned to it (dual watch). Your TX frequency on MAIN never moves.
  6. Double click a caller: the QSO is written to the ADIF file (VKVSkimmer_CW.adi or VKVSkimmer_RTTY.adi).
  7. Click RUN ON again to leave RUN mode: the previous view is restored.
NOTEA fast second engine analyses only the RUN window (CW: every 1.5 s over 9 s instead of every 5 s over 15 s; RTTY: every 2 s over 8 s), so a caller appears quickly. A call read once is shown at once as provisional (dashed, italic) and becomes normal when the main engine confirms it. The RUN engine never spots: nothing it reads goes to telnet or RBN.

SUB tuning and the window that follows the radio need the Icom direct I/Q input. With an SDR the click moves the listen frequency inside the I/Q.

6. Telnet cluster

The skimmer is its own DX cluster. Every published spot is sent as a standard line, for example:

DX de F5VKV-#:   14021.1  F5VKV        CW    37 dB  25 WPM  CQ     1417Z
PortCWRTTYContent
port73007301Spots (filtered by spot_mode, default cq: stations heard calling)
heard_port73107311Every confirmed call, whatever spot_mode. 0 = off

With a telnet client

telnet 127.0.0.1 7300

Type your callsign when asked. The Windows telnet client must be enabled (Windows Features > Telnet Client); PuTTY works too (connection type Telnet).

A telnet client connected to the skimmer cluster.

N1MM Logger+

  1. Open the Telnet window.
  2. In the Clusters tab add a cluster with address 127.0.0.1 and port 7300 (CW) or 7301 (RTTY).
  3. Select it and click Connect. The skimmer spots appear in the Telnet window, in the band maps and on the Spectrum Display.

DXLog and other loggers

Add a telnet cluster with host 127.0.0.1 and the same port. From another PC on the network use the IP address of the skimmer PC (the telnet ports accept connections from the network; allow them in the Windows firewall).

7. Spectrum in N1MM+

The skimmer can send the spectrum it already computes (the analysed band, about 50 Hz per point) to the N1MM+ Spectrum Display. N1MM+ does not need to open the radio: no I/Q is shared.

Skimmer: Settings > Spectrum output for the logger.
  1. In the skimmer: Settings > Spectrum output for the logger: switch on Send the spectrum to N1MM+, N1MM+ PC 127.0.0.1, UDP port 13064, External Source Name Skimmer, lines per second 4. Click Save spectrum output and restart the skimmer.
  2. In N1MM+: open the Spectrum Display window, right click, Settings.
  3. Spectrum Source: External (WB, Flex, etc); External Source Name: Skimmer (the same name as in the skimmer). OK.
NOTEThe RTTY skimmer uses the name Skimmer RTTY by default: use that name in N1MM+ for the RTTY spectrum. The name in N1MM+ must match the one in the skimmer.
N1MM+: Spectrum Setup with the External source named Skimmer.
N1MM+ with the skimmer spectrum and the skimmer cluster in the Telnet window.

8. Sending spots to the RBN (RBN Aggregator)

The RBN Aggregator (free, from reversebeacon.net; it needs Microsoft .NET Framework 4) receives the spots of a skimmer over telnet and forwards them to the Reverse Beacon Network. VKVSkimmer has a dedicated port that behaves like VE3NEA's Skimmer Server, so Aggregator connects to it as usual.

REQUIREDTwo settings are required: the RBN telnet port (rbn_port, 0 = off) and your locator (operator_grid, 4 or 6 characters). Your callsign must be set too. After changing the port or the locator, restart the skimmer.

In the skimmer

Skimmer: Settings, RBN section (here port 7301, used while the RTTY skimmer is not running: see the note below).
  1. Settings > RBN telnet port (Aggregator): a free port, for example 7302.
  2. Your locator (RBN): your Maidenhead locator, for example JN33RR.
  3. Your QTH (RBN): optional, written in the banner.
  4. Restart the skimmer.
NOTEPick a port no other program uses. The RTTY skimmer's cluster uses 7301 by default: if you run both skimmers, give each one its own RBN port (for example 7302 for CW and 7303 for RTTY).

In RBN Aggregator: Connections tab

Aggregator 6.7, Connections tab: primary skimmer on 127.0.0.1 and the skimmer's RBN port.
  1. Primary Skimmer Connection: IP Address 127.0.0.1 (or the skimmer PC), Port = the skimmer's RBN port. Password: empty.
  2. Callsign: the name Aggregator uses to log in to the skimmer. The spots always carry the callsign set in VKVSkimmer.
  3. Click Connect. Tick Should Aggregator connect to the Primary Skimmer automatically to reconnect at every start.
  4. RBN Connection Status must show Connected to the RBN Server.

Check the traffic: Skimmer Traffic tab

Skimmer Traffic: the skimmer banner, the SETT answer with the analysed ranges, and the spots (+ = sent to the RBN).
  • The banner shows Skimmer Server v.VKVSkimmer_CW 1.5.18 is operated by ..., F5VKV and your locator.
  • The SETT: line shows the validation level and the analysed ranges.
  • Spot lines with + after the time are sent to the RBN.
  • Only stations calling CQ / TEST / UP and beacons are sent; TEST and UP are sent as CQ, as Skimmer Server does (rbn_comment = cq).

9. RBN Reference (incoming RBN spots)

RBN Reference is the opposite direction: the skimmer reads the RBN spots and uses them to confirm, hold or reject its own candidates. It never creates or corrects a callsign. Enable it with rbn_reference = yes in the INI file; it logs in to the RBN with your callsign. If the RBN cannot be reached, the skimmer works normally on its own evidence.

  • A call heard by 2 or more RBN skimmers on the same frequency is published at once.
  • A truncated or busted reading, when the RBN strongly confirms a similar call there, is rejected (F5VK when the RBN hears F5VKV).
  • A call never heard by the RBN, on a frequency where many skimmers hear another station, is a caller of that station: not published.
  • A call without RBN evidence waits up to rbn_reference_hold_sec (default 5 s), then the local decision applies.
  • Inside the RUN window of the GUI the calls are not checked against the RBN.

10. Contests

  • spot_mode (also in the GUI): cq (default: stations heard calling in the last 3 minutes), runner, runner_unknown or all.
  • contests.txt lists the contests and the words they send after CQ (CQ WPX, CQ RDXC...). Download the new copy from vkvskimmer.com and replace the file; nothing is downloaded automatically.
  • calling_words: extra words that mean calling, comma separated.
  • VKVSkimmer_CW_with_logs.bat contest / VKVSkimmer_RTTY_with_logs.bat contest: the wider [bands.contest] ranges.

11. Troubleshooting

ProblemWhat to check
Stations in the GUI but no spots on telnetYour callsign (red SET YOUR CALLSIGN warning). spot_mode = cq spots only stations heard calling.
Aggregator does not connectrbn_port not 0, operator_grid set, skimmer restarted, same port in Aggregator, port not used by another program.
Logger does not connectPort 7300 (CW) / 7301 (RTTY); another program on the same port; Windows firewall when the logger is on another PC.
Icom: no inputUSB I/Q Package installed, IC-7610 firmware 1.20+, [USB 2] on a USB 3.0 port with a USB 3.0 cable, FTD3XX.dll next to the program.
RTL-SDR: no inputrtl_tcp.exe and its DLLs next to the program, WinUSB on Interface 0 with Zadig (again after a big Windows update), dongle not used by another program.
SDRplay: no inputSDRplay API 3 installed and its service running; SDRuno / SDRconnect closed.
Lost data / slow analysisSettings > Profiles: LIGHT. Laptop on AC power. Waterfall OFF in the browser.
GUI does not openOpen http://127.0.0.1:8073/ (CW) or :8074/ (RTTY) by hand; web_open = yes.
Some stations are never spottedBy design: if a call, a prefix or the CQ role is uncertain, it is not published.

Reporting a problem

Write to the address on vkvskimmer.com with your callsign, radio / input, Windows version, UTC time, frequency, the call you expected, and the log ZIP that the _with_logs.bat file writes in the logs folder when the program stops (start the program with that BAT file when you want to report a problem).

SUPPORT THE PROJECT

VKVSkimmer is free. Keep it on the air.

No licence, no subscription. If the skimmer is useful in your shack or in a contest, a coffee on Ko-fi helps cover development, test hardware and hosting.

Donate on Ko-fi