Skip to content

WSJT X Integration

Jeremy Fielder edited this page Mar 19, 2026 · 4 revisions

WSJT-X Integration

AetherSDR includes a built-in Hamlib rigctld server for CAT control with WSJT-X and other digital mode applications.

Quick Setup

WSJT-X Settings

  1. Open WSJT-X → SettingsRadio tab
  2. Set Rig: Hamlib NET rigctl
  3. Set Network Server: 127.0.0.1:4532
  4. Click Test CAT — should turn green

WSJT-X Audio Settings

  1. Go to SettingsAudio tab
  2. Soundcard Input: Select your radio's audio output (or AetherSDR DAX device if configured)
  3. Soundcard Output: Select your radio's audio input

AetherSDR Settings

  1. The rigctld server auto-starts if enabled in Settings → Autostart rigctld with AetherSDR
  2. Or manually enable in the DIGI applet → rigctld → Enable
  3. Default port: 4532

Alternative: Direct FlexRadio Connection

WSJT-X has built-in FlexRadio support. You can connect directly:

  1. Set Rig: FlexRadio 6xxx
  2. Set Network Server: <radio IP>:4992
  3. This bypasses AetherSDR's rigctld entirely

Multi-Channel CAT

AetherSDR provides 4 independent CAT channels (A-D), each bound to a slice:

Channel TCP Port PTY Path Slice
A 4532 /tmp/AetherSDR-CAT-A Slice 0
B 4533 /tmp/AetherSDR-CAT-B Slice 1
C 4534 /tmp/AetherSDR-CAT-C Slice 2
D 4535 /tmp/AetherSDR-CAT-D Slice 3

This allows running WSJT-X, Varac, fldigi, etc. simultaneously, each controlling its own slice.

Troubleshooting

  • WSJT-X "Test CAT" takes a long time — This is normal. WSJT-X runs a test-tune sequence on first connect (changes frequency, checks response). Takes 10-30 seconds.
  • PTT not working — Make sure the correct slice has TX assigned (red TX badge in AetherSDR).
  • Frequency not syncing — Verify the rigctld port matches in both apps.

Clone this wiki locally