Brief description of the FT8-Helper  -  Version Beta 1.4

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 15 sec.

The human interface:

Mode: FT8 or FT4 (FT4 only with WSJT-X 2.1). Be sure to set the same mode in WSJT-X.

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

Band usage:  Shows the fill level of the band between 500 und 2800 Hz

Free: Shows the most usable free frequency calculated by the FT8-Helper. It only works in RUN-mode if “Auto-Frq” is set.

Start „Run Mode“:

In „Run-mode“ FT8-Helper will call CQ continuously. Succesfully 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. If no answer received after an amount of CQ calls (currently set to the fixed value of 5), the FT8-Helper goes into a short “sleep cycle”. After expiring the sleep time it starts calling CQ again.
“Run Mode” should be always used with checked “Hold TX-Freq” box in WSJT-X.

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 15 sec. cycles. From this data it calculates the most usable free frequency between 500 and 2800 Hz.

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.

Unfortunately the Auto-Frq procedure is not full reliable, especially if the band usage is over 70%. Reason for it is, that only stations sending in FT8-signal can be regarded and only if the signals could be decoded by WSJT-X.
On this reason, when using "Auto-Frq", the WSJT-X decoding should be set to "Deep".

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" sesssion 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 a 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.

- “S&P Mode” should be used with unchecked “Hold TX-Freq” box in WSJT-X.


After start of RUN und S&P the FT8-Helper requires at least 30 sec to synchronize the data with WSJT-X. If „Auto Frq“ used in RUN-mode, additional 1 minute will required to calculate the free frequency.      


Both  RUN, and S&P Mode can be stopped by clicking to the “Stop” button. It is not possible to switch direct from RUN to S&P or back. You should go always over “Stop”.

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.

  • 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

  • Call 1st:          checked

  • Hold Tx Freq. Run-Mode: checked, S&P Mode: not checked.

  • 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:
    - Tranmsitted messsge
    - CQ in message
    - My Call in message
    - Any other New Call, DXCC, GRID, ITU or CQ-Zone, New Continent, etc. anccording 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 bandwith. Do not use Auto-Freq if the bandwith 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 hight 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.

Have a fun testing the FT8-Helper

73´DX Geza DG5LP

Bug reports to: dg5lp@darc.de