Skip to content

JTDX-VU v0.7.0

Choose a tag to compare

@vu2cpl vu2cpl released this 07 Oct 01:35
· 181 commits to jtdx-vu since this release

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)

  1. Download the zip for your Mac (Apple menu > About This Mac: "Apple
    M…" chip = arm64, "Intel" = x86_64) and double-click it to unzip.
  2. Drag JTDX-VU into Applications.
  3. 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
  4. 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.
  5. 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:
    sudo sysctl -w kern.sysv.shmall=32768 kern.sysv.shmmax=33554432
    That lasts until the next restart. To make it permanent, download
    Darwin/com.jtdx.sysctl.plist from
    this repo and run
    sudo cp com.jtdx.sysctl.plist /Library/LaunchDaemons/.
    It may need redoing after a macOS upgrade.
  6. 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)

  1. 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.
  2. Right-click > Extract All… to a folder of your choice, for example
    C:\JTDX-VU. No installer and no administrator rights are needed.
  3. Run bin\jtdx.exe in that folder. If Windows SmartScreen says
    "Windows protected your PC", click More info > Run anyway (the
    program is not code-signed). Right-click jtdx.exe > Send to >
    Desktop (create shortcut) for a desktop icon.
  4. If Windows Firewall asks, allow access on private networks (JTDX-VU
    talks UDP to logging programs such as Log4OM, N1MM or JTAlert).
  5. 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.

  1. Download jtdx-vu-0.7.0-linux-arm64.deb, then in a terminal in the
    download folder:
    sudo apt update
    sudo apt install ./jtdx-vu-0.7.0-linux-arm64.deb
    Keep the ./ - 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
    jtdx package can't be installed alongside; apt offers to remove it.
  2. 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
  3. Start JTDX-VU from the menu (Sound & Video / Ham Radio), or run
    jtdx in 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.