Repository navigation
JTDX-VU v0.7.0
JTDX-VU for VUCG v0.7.0. FlexRadio over VITA-49 with no SmartSDR in the path, QO-100 satellite operation, profiles for several rigs, the rig's mode shown beside the frequency, FT2 decoding level with MSHV, and 70cm / 23cm band buttons.
What's new in v0.7.0
- FlexRadio over VITA-49, no SmartSDR needed. New rigs FlexRadio VITA-49 Slice A..H: put the radio's address and port 4992 in the CAT field, choose PTT via CAT, and tick Use TCI / VITA-49 Audio. JTDX-VU talks to a FLEX-6000/8000 directly - receive and transmit audio go over the radio's own DAX streams, so no DAX driver, virtual sound card or TCI bridge is needed. The TX slider is the radio's RF power (it follows the radio's per-band setting; while tuning it is the tune power). Each connection puts the slice back on your last frequency in DIGU. No split: use Fake It or None. Ported from the MSHV-Mac Flex backend.
- FlexRadio panel (View > FlexRadio Panel...): the radio's meters (power, SWR, ALC, PA temperature, supply), the slice's RX / TX antenna and mode, transmit, tune and max power, the antenna tuner, and the M-series front speaker. Antennas are remembered per band for transverter users.
- Rig mode shown. The round rig-status light left of the frequency is now a box with the mode the rig reports (DIGU, USB, LSB...): green when it is the mode set in Settings > Radio, yellow when not, so a radio left in LSB after a band change stands out. Orange while connecting, red ERR on a rig control failure (click it to reset).
- QO-100. A QO-100 band button tunes FT8 on the satellite (10489.540 MHz downlink, 2400.040 MHz uplink). QSOs log as LoTW wants: FREQ / BAND = uplink (13cm), FREQ_RX / BAND_RX = downlink (3cm), PROP_MODE SAT, SAT_NAME QO-100, SAT_MODE SX. New-DXCC colours check against 13cm, and PSK Reporter spots go out on the uplink. With SDR-Control for Icom and a transverter, Settings > Frequencies > Frequency Calibration > QO-100 rig IF (for example 28.540) is what JTDX-VU sends the radio; its readback is shown as 10489.540.
- Profiles. A Profile menu keeps one complete settings set per rig or setup (say one for VITA-49, one for TCI, one for QO-100). New profile from current... copies your settings, and a plain launch opens the profile you used last.
- FT2 decodes as deep as MSHV. MSHV's log-sum-exp demapper, extra LLR sets and passes, and its AP7 a-priori decoding: once a call pair has been decoded, the station's expected reply two periods later is matched against the likely messages, so reports a few dB below the normal floor still decode (shown with a trailing
7). Measured against MSHV on identical audio: the same decode floor and no false AP7 decodes. MSHV prints FT2 reports 2-3 dB lower for the same signal, so compare counts, not numbers. - 70cm and 23cm band buttons for European UHF/SHF FT8/FT4 activity: tick them in View > Band & Mode Buttons... A 23cm FT8 frequency (1296.174 MHz) is in the default frequency list for new or reset lists. Thanks to Frank PH2M for asking.
Fixes
- No crash while TCI is reconnecting. A frequency, PTT or rig restart arriving while the TCI link was still connecting could crash JTDX-VU.
- No crash on some false JTTY decodes. A rare corrupt frame could make the JTTY decoder read outside its tables.
Tried on air: QO-100 with SDR-Control, and the FlexRadio rig's connection, receive and band changes on a FLEX-6600. FT2 was measured against MSHV on identical simulated audio. FlexRadio transmit and the panel's power controls are tested on a simulated radio only - start at low power and please report anything odd.
Known issue (AetherSDR)
If you use AetherSDR's TCI: version 26.9.5 stops sending TCI audio when no TCI client has been connected for more than 10 seconds (aethersdr/AetherSDR#6006); the fix is merged for AetherSDR's next release. Restart AetherSDR when JTDX-VU says "no audio from the SDR program". The new FlexRadio rig type avoids TCI altogether.
Downloads
| Platform | File | Runs on |
|---|---|---|
| macOS, Apple Silicon | JTDX-VU-0.7.0-macos-arm64.zip |
macOS 14 Sonoma or later |
| macOS, Intel | JTDX-VU-0.7.0-macos-x86_64.zip |
macOS 15 Sequoia or later |
| Windows x64 | JTDX-VU-0.7.0-windows-x64.zip |
Windows 10 / 11, 64-bit |
| Raspberry Pi / Linux arm64 | jtdx-vu-0.7.0-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.0-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). - 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.0-linux-arm64.deb, then in a terminal in the
download folder:Keep thesudo apt update sudo apt install ./jtdx-vu-0.7.0-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.