
Why a WSJT-X 3.x Upgrade Can Break a Previously Good FT8 Station
Upgrading WSJT-X is usually worthwhile, but it can expose weak spots in an FT8 station that were previously hidden: a renamed audio device, a changed CAT port, a different default behavior, or a radio menu setting that no longer matches the software. The official WSJT-X download page and release notes show active 3.x development, including the April 2026 3.0.0 feature set, June 2026 3.0.2 fixes, and later 3.2.0 release-candidate work. That pace is good for capability, but it also means operators should treat a major upgrade like a station checkout, not just a routine app launch.
This WSJT-X FT8 setup guide focuses on the settings that most often decide whether you decode reliably, transmit cleanly, and avoid chasing false problems. It is written for typical US HF operation, but licensing privileges, allocations, power limits, RF exposure requirements, and band plans vary by jurisdiction. Always follow your current regulator rules and the manufacturer instructions for your radio and interface.
Start With a Clean Baseline
Before changing menus at random, make a baseline. Confirm the installed version from within WSJT-X, read the current notes, and verify that your old configuration was imported as expected. If you are moving from a stable 2.x installation to a current 3.x build, keep a copy of your old configuration and log files before experimenting.
- Confirm time synchronization: FT8 needs accurate computer time. Use a reliable time service and verify that the clock is within about a second of network time.
- Confirm the correct mode: Select FT8 for ordinary contacts. Do not use Fox/Hound or SuperFox-related behavior unless the DX station specifically announces that operating style.
- Confirm the band and frequency: Make sure the radio and WSJT-X agree. If the displayed band is wrong, logging, alerts, and transmit control may also be wrong.
- Confirm your station details: Check call sign, grid square, IARU region if applicable, and reporting preferences.
Do not assume that because decodes appear, everything is correct. A station can decode well while transmitting with distorted audio, disabled split behavior, or an incorrect logging path.
CAT Control: Make the Radio and WSJT-X Agree First
CAT control is the foundation for an orderly WSJT-X FT8 setup. Without it, WSJT-X may not know the band, cannot reliably control frequency, and may fail to use split correctly. In the Radio settings, select the correct rig model or an appropriate Hamlib-compatible option, then choose the correct serial port, baud rate, data bits, stop bits, handshake, and PTT method for your radio.
After an upgrade, the most common CAT problem is not the software itself. It is that the operating system renamed the USB serial adapter or the radio now appears on a different port. Windows updates can also reassign COM numbers, and some radios expose more than one virtual port. If Test CAT fails, verify the port in the operating system device list before changing every WSJT-X setting.
Practical CAT Checklist
- Test CAT before transmit: Use the built-in CAT test. The frequency display should follow the radio and the radio should follow WSJT-X band changes.
- Choose one PTT path: Use CAT, RTS, DTR, or VOX intentionally. Avoid enabling multiple push-to-talk paths unless the radio manual requires it.
- Use data mode when available: Many modern transceivers have USB-D, DATA-U, or similar modes that route audio through the USB interface and apply digital-mode settings.
- Check frequency polling: If the display lags badly or jumps, reduce conflicts with other logging or control software.
- Close competing programs: Only one program should normally control the same serial CAT port unless you use a proper rig-control server or virtual port arrangement.
If CAT works but PTT does not, separate the problem. First confirm CAT frequency control. Then test PTT. Then test audio. Combining all three at once makes troubleshooting much harder.
Audio Input: Decode Reliably Without Clipping
FT8 decoding depends on clean receive audio. In WSJT-X, the receive level indicator should sit in a healthy range without running into overload. The exact display behavior can vary by version and operating system, but the principle does not: avoid both a barely moving level and a constantly saturated one.
Set the radio for a reasonably wide digital receive passband, then adjust the computer recording level and radio output level so the waterfall shows signal texture without heavy clipping. If every strong station is a thick block, the sound path may be overdriven. If the waterfall is nearly empty while the radio S-meter is active, the wrong audio device may be selected or the level may be too low.
Receive Audio Steps
- Select the radio USB audio device or external interface input, not the laptop microphone.
- Turn off operating-system enhancements, noise suppression, automatic gain, and communications ducking where possible.
- Use a stable sample rate expected by the software and device. Many digital-mode interfaces work well with 48 kHz settings, but follow your device documentation.
- Adjust the radio audio output and computer recording gain together. Do not use maximum levels everywhere.
- Watch the waterfall across several FT8 cycles before deciding the level is wrong.
A useful test is to tune to an active FT8 segment and observe both weak traces and strong local signals. You want weak signals visible and strong signals not flattened into audio mush.
Transmit Audio: Clean FT8 Beats Loud FT8
FT8 is a narrow, structured digital signal. It does not benefit from speech processing, compression, aggressive equalization, or ALC-driven audio. After a WSJT-X upgrade, verify transmit audio before calling CQ or answering DX. A station that is too hot may still complete contacts, but it can create unnecessary splatter, intermodulation products, and complaints.
The usual approach is simple: set the radio to its digital mode, turn off speech processor and transmit EQ effects unless the manufacturer specifically recommends otherwise, set RF power to a reasonable level, and use the WSJT-X power slider plus the operating-system playback level to keep ALC minimal or absent. Many operators aim for no visible ALC action on radios where that is the manufacturer recommendation for data modes. Some radios meter ALC differently, so the radio manual remains the authority.
Transmit Audio Checklist
- Use the correct playback device: Select the radio or interface speaker output, not the computer speakers.
- Disable processor features: Speech processing, compressor, noise gates, and voice equalizers are usually wrong for FT8.
- Set power deliberately: FT8 has a high duty cycle. Use conservative power that your radio, tuner, feed line, and antenna system can sustain.
- Watch ALC and current draw: Reduce audio drive if ALC rises unexpectedly or the transmitter sounds strained.
- Check SWR and heat: Digital duty cycle stresses equipment more than casual SSB voice operation.
For example, if your transceiver is set to 50 watts but the ALC meter moves hard on every FT8 transmit cycle, reduce the audio drive rather than simply reducing RF power. The goal is not maximum meter movement. The goal is a clean RF envelope at the desired output.
Split Mode: Why Fake It and Rig Matter
WSJT-X can manage transmit audio placement in ways that help keep the generated tone in a clean part of the audio passband. Split operation is part of that strategy. Depending on the radio, WSJT-X may offer options such as using the rig split function or a software-managed method often called Fake It. The best choice depends on how well your radio supports CAT split and how cleanly it behaves with audio tones across the passband.
If your radio supports reliable CAT split, Rig may work well. If not, Fake It often provides practical frequency management by shifting the radio frequency while keeping the audio tone in a better range. The important point is not the name of the option; it is that your transmitted FT8 signal should be generated cleanly and land where WSJT-X says it will land.
- Use the WSJT-X Tune function only into a proper load, antenna system, or safe station setup.
- Confirm that changing TX audio frequency does not produce strange jumps or transmit outside the intended passband.
- Do not disable split just because it seems simpler. Test it first, especially if you operate across the full FT8 waterfall.
Filters and Passband: Do Not Decode Through a Keyhole
One common post-upgrade complaint is missing decodes. Sometimes the software is fine; the radio filter is too narrow. FT8 activity commonly occupies a few kilohertz of audio spectrum. If the transceiver is still using a narrow CW, RTTY, or custom data filter, WSJT-X will only see part of the activity.
For ordinary FT8, use a digital receive filter wide enough to cover the active audio range shown in the waterfall. Many operators use about a 3 kHz receive bandwidth when the radio and local interference conditions allow it. If you are fighting a strong nearby signal, narrowing the filter may help, but remember that anything outside the passband cannot be decoded.
Filter Settings That Matter
- Receive bandwidth: Wide enough to cover the wanted FT8 waterfall, not accidentally set to a very narrow filter.
- Transmit bandwidth: Compatible with the selected digital mode and tone range.
- Notch filters: Useful against a carrier, but a deep notch can erase decodable FT8 signals.
- Noise reduction: DSP noise reduction can sometimes make the waterfall look cleaner while making decodes worse. Compare on and off.
- AGC: Use a setting that avoids pumping from strong signals. Exact recommendations vary by radio.
If decodes appear only below 1500 Hz on the waterfall, suspect a receive filter or audio routing issue. If you see signals but decode none, suspect time synchronization, wrong mode, or severe audio distortion.
Alerts, Colors, and Logging: Recover Your Operating Workflow
After the radio transmits and decodes properly, rebuild the operating workflow. Alerts and colors help you notice wanted grids, states, DXCC entities, call signs, or CQ messages. Logging confirms that completed QSOs are saved where you expect them. These features are easy to overlook during an upgrade because they do not stop FT8 from working, but they affect how useful the station feels.
- Review color rules: Confirm that wanted DXCC, wanted grid, worked-before, and CQ highlighting still match your goals.
- Check audio alerts: Make sure alerts are not muted by the operating system or routed to the wrong output.
- Verify log location: Confirm that WSJT-X is writing to the expected ADIF log file.
- Confirm external logging: If you use a separate logger, confirm UDP, TCP, file import, or companion app settings after the upgrade.
- Test with one real QSO or a dummy-safe review: Do not wait until a rare station appears to discover that logging is broken.
Be careful with automated behavior. Alerts are aids, not substitutes for operator judgment. Confirm call signs, reports, and band information before logging or uploading.
SuperFox and Hound Behavior: Use It Only When Appropriate
SuperFox-related operation is intended for specific high-rate DXpedition-style scenarios, not normal everyday FT8 calling. The official SuperFox User Guide should be your primary reference because behavior, terminology, and authentication details can change with current releases. In practical station terms, the most important rule is simple: do not enable SuperFox or Hound-style settings unless the DX station instructions call for them.
For ordinary FT8, leave the station in normal FT8 behavior. For a published DXpedition using SuperFox, read the operator instructions before transmitting. Expect the software to manage certain transmit and receive behaviors differently than normal FT8. Do not manually fight the program by constantly moving your transmit audio, retuning the VFO, or changing modes mid-sequence unless the guide or DX station instructions tell you to do so.
SuperFox Readiness Checklist
- Install a current WSJT-X build from the official source, not an unknown mirror.
- Read the current SuperFox User Guide before the event.
- Confirm your clock, CAT, split, and audio levels in normal FT8 first.
- Use SuperFox/Hound behavior only for stations explicitly operating that way.
- Follow the DX station instructions for calling frequency range, sequencing, and logging expectations.
If you cannot decode the SuperFox station, fix receive first. If you can decode but never receive a response, do not assume more power is the answer. Check that you are using the correct operating mode, transmit audio range, timing, and split behavior.
A Fast Troubleshooting Flow After an Upgrade
When FT8 stops working after a WSJT-X 3.x upgrade, troubleshoot in layers:
- No waterfall: Wrong input device, muted radio audio, incorrect data mode, bad USB audio selection, or operating-system privacy/audio setting.
- Waterfall but no decodes: Bad computer time, wrong mode, too much distortion, too-narrow filter, or audio level far outside the useful range.
- Decodes but no transmit: PTT method wrong, CAT conflict, radio in receive-only state, wrong sound output, or transmit disabled in WSJT-X.
- Transmits but no one answers: Overdriven audio, no split control, antenna/SWR issue, poor propagation, wrong band, or calling outside the expected audio range.
- Logged contacts missing: ADIF path changed, external logger not listening, network permissions changed, or operator did not complete the log prompt.
Change one thing at a time. Write down the original setting before altering it. The fastest repair is often restoring the correct audio device or COM port, not reinstalling the program.
Key Takeaways
- A WSJT-X 3.x upgrade deserves a full station checkout: CAT, audio input, audio output, split, filters, alerts, and logging.
- Clean transmit audio matters more than loud audio. Avoid processor features and excessive ALC.
- Wide enough receive filtering is essential for seeing the FT8 activity you expect to decode.
- Split behavior helps keep transmit tones in a clean operating range; test Rig or Fake It with your radio.
- SuperFox/Hound behavior is specialized. Use it only when the target station and official guide call for it.
FAQ
Should I reinstall WSJT-X if FT8 stops decoding after an upgrade?
Usually not as the first step. Check computer time, audio input device, receive level, radio filter width, and selected mode first. Many post-upgrade failures are configuration or device-selection problems.
How much power should I run on FT8?
Use the minimum power needed for the contact conditions while staying within your license privileges, equipment ratings, RF exposure limits, and good amateur practice. FT8 is high duty cycle, so heat and clean audio drive are important.
Is SuperFox the new normal FT8?
No. Treat SuperFox-related operation as a specialized DXpedition-style tool. For everyday contacts, use normal FT8 unless the station you are calling specifically announces another procedure.
Why did my logger stop receiving QSOs?
An upgrade can change paths, permissions, network behavior, or UDP settings. Confirm the WSJT-X log file location and any external logger connection settings before assuming the QSO data is lost.




