Repository navigation
JTDX-VU v0.7.4
JTDX-VU for VUCG v0.7.4. FlexRadio VITA-49 now works through a firewall, NAT or VPN; a Discover button for the radio's address; US states beside U.S.A. stations; and QO-100 alerts on the right band. Everything else is as in v0.7.3.
What's new in v0.7.4
- FlexRadio audio through a firewall, NAT or VPN. The radio sends its audio (VITA-49) to the computer over UDP, and a firewall or VPN that has seen no packet going out drops it: the frequency showed, but there was no audio and no waterfall. JTDX-VU now sends the radio a small registration packet from its audio port (and again every 5 s), so the return path opens. Confirmed by VU2OY's radio over a VPN and by KK4CDK.
- No more endless reconnecting when no audio arrives. If a FlexRadio connects but no audio comes on two connects in a row, JTDX-VU stops and says why - usually a firewall: on Windows, allow JTDX-VU (
jtdx.exe) through Windows Firewall on private networks. Click the red ERR box beside the frequency to try again. - The red ERR box reconnects. It stayed green and greyed out after a failure; it now stays red and clickable.
- One frequency at connect. On connecting, the slice is set to your last JTDX-VU frequency and data mode once, instead of the radio's and JTDX-VU's frequencies taking turns.
- "FlexRadio:" address box with Discover. For the FlexRadio VITA-49 rig, Settings > Radio now labels the address box FlexRadio: (e.g.
192.168.1.20:4992), and Discover listens 3 s for the radio's broadcast and fills it in. Discovery works only on the radio's own LAN, not over a VPN or between VLANs: there, type the address. If nothing is set, the error now says where to set it. - Show US State (Settings > General, beside Show DXCC names; needs Show DXCC names on). U.S.A. stations show as
U.S.A.:FL. The grid in the message is used first; a square that covers several states lists them, largest share first (U.S.A.:KY-IN-OH). Without a grid, the state comes from the FCC licence database - the licence address, so a portable or moved station can show its home state. Both tables are built in, from public-domain US Census state boundaries and the FCC's weekly amateur dump. Asked for by Miguel KK4CDK, after the option in JTDX 2.2.160. - QO-100: Club Log alerts and JTTY status on 13cm. The dial is the 10 GHz downlink, so these two looked the band up as 3cm and alerted stations already worked on QO-100 as "New band". They now use the 13cm uplink, as the decode window and logging already did.
- README: Common problems. The "Unable to create shared memory segment" fix, and why the same message can show at several frequencies (RX level too high - lower it, or tick Hide FT8 dupe messages in the Misc menu in the menu bar).
AetherSDR users
AetherSDR 26.9.5 stopped sending TCI audio after a TCI client reconnected (aethersdr/AetherSDR#6006). That is fixed in AetherSDR 26.10.1: update AetherSDR if JTDX-VU says "no audio from the SDR program". The FlexRadio VITA-49 rig type avoids TCI altogether.
Downloads
| Platform | File | Runs on |
|---|---|---|
| macOS, Apple Silicon | JTDX-VU-0.7.4-macos-arm64.zip |
macOS 14 Sonoma or later |
| macOS, Intel | JTDX-VU-0.7.4-macos-x86_64.zip |
macOS 15 Sequoia or later |
| Windows x64 | JTDX-VU-0.7.4-windows-x64.zip |
Windows 10 / 11, 64-bit |
| Raspberry Pi / Linux arm64 | jtdx-vu-0.7.4-linux-arm64.deb |
Raspberry Pi OS / Debian 12 (bookworm), 64-bit |
Each file has a matching .sha256 checksum. JTDX-VU installs alongside a
stock JTDX on macOS and Windows; on the Pi the package replaces a stock
jtdx package.
How to install
macOS (Apple Silicon or Intel)
- Download the zip for your Mac (Apple menu > About This Mac: "Apple
M…" chip = arm64, "Intel" = x86_64) and double-click it to unzip. - Drag JTDX-VU into Applications.
- First launch. The app is ad-hoc signed, not notarized, so macOS
blocks the first open:- macOS 15 Sequoia and later: double-click JTDX-VU, click Done on
the warning, then open System Settings > Privacy & Security,
scroll down and click Open Anyway next to "JTDX-VU was
blocked", and confirm. - macOS 14 Sonoma: right-click (Control-click) JTDX-VU > Open >
Open. - Or, in Terminal:
xattr -dr com.apple.quarantine /Applications/JTDX-VU.app
- macOS 15 Sequoia and later: double-click JTDX-VU, click Done on
- Allow the microphone when asked; that is how macOS names access to
your radio's sound card. If you clicked Don't Allow, turn JTDX-VU on in
System Settings > Privacy & Security > Microphone. - Shared memory (one-time, every Mac). The decoder needs more SysV
shared memory than the macOS default; without it JTDX-VU stops with
"Unable to create shared memory segment". In Terminal:That lasts until the next restart. To make it permanent, downloadsudo sysctl -w kern.sysv.shmall=32768 kern.sysv.shmmax=33554432
Darwin/com.jtdx.sysctl.plistfrom
this repo and run
sudo cp com.jtdx.sysctl.plist /Library/LaunchDaemons/.
It may need redoing after a macOS upgrade. - Set up your callsign, radio and audio in JTDX-VU > Settings…
(Cmd+,).
Upgrading: quit JTDX-VU, replace the app in Applications with the
new one, and repeat step 3 if macOS asks. Settings
(~/Library/Preferences/JTDX-VU.ini) and data
(~/Library/Application Support/JTDX-VU) are kept.
Windows 10 / 11 (64-bit)
- Download
JTDX-VU-0.7.4-windows-x64.zip. Before unzipping,
right-click the zip > Properties, tick Unblock, OK; this saves
a warning for every file inside. - Right-click > Extract All… to a folder of your choice, for example
C:\JTDX-VU. No installer and no administrator rights are needed. - Run
bin\jtdx.exein that folder. If Windows SmartScreen says
"Windows protected your PC", click More info > Run anyway (the
program is not code-signed). Right-clickjtdx.exe> Send to >
Desktop (create shortcut) for a desktop icon. - If Windows Firewall asks, allow access on private networks (JTDX-VU
talks UDP to logging programs such as Log4OM, N1MM or JTAlert, and
receives a FlexRadio's audio over UDP). - For rig control through OmniRig, install
OmniRig separately. Hamlib, TCI
and the other rig interfaces are built in.
Upgrading: quit JTDX-VU and extract the new zip over the old folder
(or into a new one). Settings are stored in your Windows profile, not
in the program folder, so they are kept.
Raspberry Pi / Debian 12 (arm64)
Needs a 64-bit Raspberry Pi OS (Bookworm) or Debian 12 on arm64 - a Pi 4
or Pi 5 is recommended.
- Download
jtdx-vu-0.7.4-linux-arm64.deb, then in a terminal in the
download folder:Keep thesudo apt update sudo apt install ./jtdx-vu-0.7.4-linux-arm64.deb
./- it tells apt to install the file rather than look for
a package by that name. apt pulls in Qt, Hamlib and FFTW. A stock
jtdxpackage can't be installed alongside; apt offers to remove it. - For CAT control over a USB serial cable, give your user access to
serial ports once, then log out and back in:sudo usermod -aG dialout $USER - Start JTDX-VU from the menu (Sound & Video / Ham Radio), or run
jtdxin a terminal.
Upgrading: install the new .deb the same way; settings are kept.
Removing: sudo apt remove jtdx-vu.
Credits
Based on JTDX by Igor Chernikov UA3DJY, Arvo Järve ES1JA and the HF community. JTDX is itself derived from WSJT-X by Joe Taylor K1JT, Bill Somerville G4WJS, Steve Franke K9AN, Nico Palermo IV3NWV and others.
JTTY is by Joe Taylor K1JT, Steve Franke K9AN, Rob Sherwood G4KLA and the WSJT-X development group (WSJT-X 3.2.0-rc1, GPL v3). FT2 was created by Martino Merola IU8LMC (ARI Caserta), with Salvatore Raccampo 9H1SR as lead C++ developer; it first went on air in Decodium on 2026-02-16 (ft2.it), and MSHV by Hrisimir Hristov LZ2HV added it in 2.76.5 on 2026-03-24. JTDX-VU uses no Decodium code: its FT2 is JTDX's own FT4 chain, with MSHV's implementation as the reference. The band/mode buttons, the "show only new" filter and the DXCC colour scheme follow MSHV by LZ2HV. The QO-100 logging follows MSHV. The FlexRadio VITA-49 backend and panel are ported from the MSHV-Mac port's native Flex backend. Show US State uses US Census Bureau state boundaries and the FCC amateur licence database (both public domain), with the same rules as DXClusterAggregator's WAS lookup.