Brief description of the FT8-Helper for WSJT-X -  V 1.7.2

.+++ New:++   JTDX-Helper 2.0 is for JTDX v2.2 is available now!

The FT8-Helper program was developed as macro extension for the WSJT-X using the Quick-Macro program. Comparing to similar FT8-Robots, this program is more “intelligent”, it interprets the received messages of WSJT-X and acts according to the own pre-programmed QSO strategy. The delivered EXE file contains the licence for Quick-Macro.

The FT8-Helper controls WSJT-X via virtual mouse and keyboard commands. When the FT8-Helper is running, you should not use your computer for other applications, as the mouse focus will be caught by FT8-Helper every  7,5 or 15 sec depending on the Mode FT4/FT8.

The human interface:

Own call: Your callsign, should be entered into the local file callsign.txt.

Edit config: allows to edit the configuration file "callsign.txt"

Auto Frq:

If “Auto-Frq” checked, a free frequency will be calculated. To do it, the transmitting frequencies of all received stations are logged in four subsequent 7,4/15 sec. cycles. From this data the FT8-Helper calculates the most usable free frequency between 500 and 2800 Hz. A channel is indicated as "free" if no message is received on the given frequency during the four last sequences.  For transceiver with narrow IF-filter the upper frequency can be limited (see download page, Version history).

Important Note:  If "Auto-Frq" is used, the entire Wide-Graph window must be moved into the monitor screen and the size  may not be changed later. For monitors with lower resolutions (less then 1900 horizontal pixels) it means, that the right edge of the window must be visible, even if  left part of the Wide-Graph window overlaps the WSJT-X window.

Please note that only valid FT8-signals can be regarded when looking for a free frequency. On this reason it can happen that the frequency is set to a non-FT8/FT5 signal, e.g. noise, RTTY, MFSK or any other signal. When using the Auto-Frq feature, the "CQ-only" checkbox may not be checked.

Free channels / Use:  If Auto-Frq is selected in RUN-mode, it shows the number of free channels and the used frequency-

Start „Run Mode“:

In „Run-mode“ FT8-Helper will call CQ continuously. Successfully completed QSOs will be logged automatically. After completing or aborting the QSO due to repetition timeout, it restarts calling CQ again. The FT8-Helper manages its own timeouts and repetition limits. Repetitions are limited to 3. If no answer of not correct answer is received after the third attempt, the QSO will be indicated as "broken". If no answer received after 5 CQ calls, the FT8-Helper goes into a short “sleep cycle”. After expiring the sleep time it starts calling CQ again.

Start „S&P Mode“:

In „Search and Pounce“ mode FT8-Helper selects one from the stations calling CQ. The QSOs, similar to the “Run-mode”, will be executed automatically and –if successful- will be logged automatically. QSOs will be broken if the called station does not answers on 3 calls, or returns to another station. QSOs will be closed unsuccessful if no report received after 3 repetitions. Stations with broken QSOs are blacklisted for approx. 7 minutes to allow making QSOs with other stations.

FT8-Helper selects the CQ calling station with the highest priority, based on the standard WSJT-X highlighting colour settings.  Only the checked lines are regarded. It allows you to call e.g. only new DXCC entities, if only this line is selected. If more than one lines are selected, the upper lines in the "Decode Highlighting" session have higher priority and will be called first. Stations with “CQ-In message (green)” will be never called.

When checking the “DX-Only” box, only DX stations will be called. In any case the FT8-Helper does not call stations calling DX from local QRA-grids. Also stations calling “JA” are not called if our stations is not in Japan. Our own location and non-DX QRA grids are specified in the “ownloc.txt” file. It can be modified by the user according to the local requirements.

Automatic switch between RUN and S&P:  <-- X-->
New feature in V1.6: When starting RUN or S&P with checked feature, the selected mode ends after 20 unsuccessful QSO attempts or broken QSOs and changes to the other mode.  Running QSOs will be completed before switching. The default value of 20 can be modified in the callsign.txt file.

Halt (Stop)“: stops any activity of the FT8-Helper.
 It is not possible to switch direct between the modes. You should always press Halt first. Stopping is a "hard" stop, QSOs will not be completed. If necessary the QSO can be continued using WSJT-X manually.

Band Hopping
It allows CAT-controlled transceivers to change the bands according a pre-defined timetable.
For each band two time ranges can be specified, typically day, night and/or grayline times according to the current propagation forecast. When starting the Band Hopping function, the FT8-Helper scans the specified bands and starts RUN and/or S/P sequences on the first available band where the current time is in the specified time ranges. The sequences are stopped if the specified number of unsuccessful attempts is reached specified by MAX-RUN and MAX-S/P values. In XCHG-mode, it starts with an S/P cycle followed by a RUN. Please note that there is no fixed time periods for the band switching. At the end of the sequence it continues on the next higher band available at the current time.  If the highest band is reached, it continues again from the lowest band. The Band-Hopping field shows the current band and mode, RUN, S/P or XCHG. If no active band found, it shows "IDLE".

The band-hopping schedule can be entered into the "callsign.txt file"
;in S/P mode stations with S/N level less than -20 are not called (max. value=10)
;not used bands shall be also included without time schedule information


10:              ;
Band not activated due to bad conditions...
6:                                           ; Mot used, the line can be removed

- The specified times are local computer times.
- The optional entry "DX" checks the DX-Only checkbox.
- Band-Hopping always activates the "<-x->" and the "Auto-Frq" functions.-
- On first start of Band-Hopping it starts with the lowest available band
- When stopping and re-starting of Band-Hopping, it continues with  the next available band
- When starting, the programmed time ranges has to be confirmed.
- Before starting, be sure that your radio and antenna works well on all the specified bands.

Both  RUN, S&P and Band-Hopping Modes can be stopped by clicking to the “Stop” button. It is not possible to switch direct between the motes. You should always press “Stop” first. The stop is a "hard" stop, QSOs will not be completed. If necessary the QSO can be continued using WSJT-X manually.

Log Window:
The “Log Window” shows what the FT8-Helper just doing.

Installation and Initial Setup

  • Download  the FT8-Helper-exe-file and the "ownloc.txt”, copy them into a directory.

  • Start WSJTX, then the FT8-Helper. At first start, the callsign field is empty. Exit the program and enter your callsign into the file callsign.txt replacing "------" by your callsign. Be sure not to enter invisible characters, like white space etc.

  • At the next start of the FT8-Helper, your callsign will be shown in the “Own-Call” box.

  • Check and modify the first line of ownloc.txt” according to your location.  
    Enter your country (DXCC entity) and your continent (e.g. DL USA EU AS NA OC etc.)
    Result: in S&P mode, only stations are called if the CQ-extension matches to one of the listed items.

  • Check and modify the second line of ownloc.txt” according to your location.
    Enter the list of QRA-locator grids around of your own QTH.
    Result: In S&P-mode, stations calling DX are only called, if the calling stations own QRA is not on the list.

  • If required enter third line: List of countreis (DXCC prefix) should not be called in S/P-mode (e.g. own country).

  • Verify that WSJT-X is running well in manual mode.

  • Following settings are required In the Main-Window of WSJT-X:

  • CQ only:         not checked if "Auto Frq" is used in RUN Mode.

  • Auto Seq:       checked (from 1.7.2 is set automatically)

  • Call 1st:          checked (from 1.7.2. is set automatically)

  • Hold Tx Freq. Run-Mode: checked, S&P Mode: not checked. (from 1.7.2 is set automatically)

  • Monitor:         Running (green)

  • Enable Tx:      not enabled, will be set by FT8-Helper.

  • Menus:           checked

Required in „Settings – General“

  • My Call / My Grid:                                                 according your station

  • Autogrid:                                                                 not checked *

  • IARU Region:                                                          All *

  • Message generation for type 2 compoud.        Full call in TX3 *

  • Start new period decodes at top:                       not checked

  • Blank line between decoding periods:              checked (suggested)

  • Display distance in miles:                                    not checked *

  • TX messages to Rx frequency window:             checked

  • Show DXCC, grid  und Show principal prefix:   both checked

  • Monitor off at startup:                                         not checked *

  • Monitor returns to last used frequency:           checked *

  • Double-click on call sets Tx enable:                   checked

  • Disable TX after sending 73.                                       not checked

  • Alternate F1-F5 bindings:                                            checked *

  • CW ID after 73:                                                              not checked

  • Single decode:                                                               checked *

  • Fonts: MS Shell Dlg2, Normal, Size=8 (WSJT-X standard)

  • Decoded Text Font:  Courier New, Normal, Size=10 (WSJT-X standard)

    Settings marked by "*'" might be not important, but tests were made with the written settings.

    Required in “Settings – Reporting”

  • Prompt me to log QSO:    not checked

    Required in “Settings – Colours”

  • All default settings, do not change them

  • The required lines can be checked,
    Suggested to check:
    - Transmitted message
    - CQ in message
    - My Call in message
    - Any other New Call, DXCC, GRID, ITU or CQ-Zone, New Continent, etc. according your needs.

Settings in "Decode"

However all settings (fast/normal/deep) can be used, consider that using "deep" can cause significant delays when sending messages. If the band is full and not all the received messages in a cycle are fitting in the Band activity window, it is suggested to change to "normal" or "fast" decoding.  You can also decrease the receiving bandwidth. Do not use Auto-Freq if the bandwidth is limited.


Settings in "Wide Grph" Window

The following settings are only requested if "Auto-Freq" is used.

  • Horizontal width:  500 - 2850 Hz must be visible.

  • Bins/Pixel:           3

  • Start:                    500 Hz

  • All other settings are not critical


The window sizes are optimized full-HD monitors with a resolution of 1920x1080 pixels. On start of FT8-Helper, both main WSJT-X and Wide-Graph windows are resized with the requested size and positions. The size of the main WSJT-X window may not be changed by the user!  The text size for windows applications must be set to 100%. If it was set correctly, you have 25 or 26 lines in the Band Activity window of WSJT-X, depending on whether horizontal scroll bar is available or not.

If a monitor with lower resolution (e.g. with 768 lines) is used, FT8-Helper reduces the height of the main WSJT-X window accordingly. In this case there are 20/21 lines visible in the Band Activity window. 

If the horizontal resolution of your monitor less than 1920 pixels, FT8-Helper resizes and sets  the Wide Graph window accordingly. The left part of the Wide-Graph window comes under the WSJT-X main window. Especially when using "Auto-Frq" in "RUN-Mode" the size and position of the Wide Graph window may not be changed.

Opening modal (blocking) dialogs during either "RUN" or "SP" mode is running will lead to crash of the FT8-Helper. It happens if you e.g. change the WSJT-X parameter settings during RUN or S&P mode is active.

 Geza DG5LP

Bug reports to: dg5lp@darc.de