SmartStreamer4

SmartStreamer4 is a Windows desktop app for running external decoders against a FlexRadio. In CW Mode it streams DAX-IQ audio into CW Skimmer and reconciles its decoded spots back to the radio's slice, with per-channel instances synchronised to your panadapter and slice frequencies. In Digital Mode it configures and launches per-slice WSJT-X, JTDX, or WSJT-Z instances (FT8/FT4) wired to DAX audio and SmartSDR CAT. It runs alongside SmartSDR.

License: MIT (see LICENSE).

Status

• Generally available as of v0.2.1 (2026-07-24). Latest release: see GitHub Releases.
• Requires SmartSDR 4.x and FlexRadio firmware ≥ 3.3.32.8203 (FlexLib 4.2.18 minimum).
• Tested against SmartSDR 4.1.5 and 4.2.x server radios.

Install

1. Download SmartStreamer4-v<version>-win-x64.zip from the latest GitHub Release.
2. Extract SmartStreamer4.exe somewhere convenient.
3. Run it. Allow firewall access if Windows prompts.

You'll need DAX installed on the same PC, plus CW Skimmer (CW Mode) and/or WSJT-X / JTDX / WSJT-Z (Digital Mode). The first time you launch SmartStreamer4 with both CW Skimmer paths set, the Set Up Wizard opens automatically and walks you through the CW configuration.

For the full operator walkthrough of both modes see SETUP_GUIDE.md, or click Setup Guide on the Help tab any time.

Build from source

Prerequisites:

• .NET 8 SDK
• Windows 10/11 (the app targets net8.0-windows)
• FlexLib API source extracted to FlexLib_API_v4.2.18.41174/ at the repo root. Download from FlexRadio: https://www.flexradio.com/software/smartsdr-v4-x-api-flexlib/

Build:

dotnet build SmartSDRIQStreamer.csproj

Plain dotnet build from the repo root pulls in the vendor FlexLib API projects, which bring unresolvable WPF references on the Windows .NET SDK. Always point at the app csproj.

Run a debug build:

dotnet run --project SmartSDRIQStreamer.csproj

Test

dotnet test tests/SmartSDRIQStreamer.CWSkimmer.Tests

The tests cover INI generation and the CW Skimmer sync tracker. They do not exercise FlexLib or live radio behaviour. See ARCHITECTURE.md for what is and isn't covered.

Release

Releases are produced by publish-release.ps1 in two phases, with live-test, tag push, and release-notes review happening between them:

git tag -a v0.2.1 -m "SmartStreamer4 v0.2.1"   # annotated, never lightweight
.\publish-release.ps1            # phase 1: build, verify embedded version, zip, write SHA256SUMS sidecar
# live-test the zip, then push the tag BEFORE publishing: git push origin v0.2.1
# confirm RELEASE_NOTES-v0.2.1.md is finalized
.\publish-release.ps1 -Publish   # phase 2: gh release create --latest with zip + sidecar attached

Phase 1 runs the full test suite, publishes a self-contained single-file exe, verifies its embedded ProductVersion matches <tag>+<sha>, zips it as SmartStreamer4-<tag>-win-x64.zip (runtime suffix matches the -Runtime parameter) together with LICENSE and THIRD-PARTY-NOTICES.txt, and writes a SHA256SUMS.txt sidecar next to the zip. Phase 2 fails fast if the tag isn't on origin, the zip is missing, the SHA256SUMS line doesn't match, or the notes file is empty; otherwise it creates the GitHub release with the zip and sidecar attached (browsers block .exe downloads, so always ship the zip). Nothing is committed, so the release commit equals the tag commit. --latest is hard-coded.

Versioning: the git tag at HEAD is the single source of truth. The csproj <Version> stays at a clean numeric default; the script reads the tag and embeds <tag>+<sha> in the published exe so the in-app version display and update check report the right release. As of v0.2.1 SmartStreamer4 is generally available and releases follow vMAJOR.MINOR.PATCH (e.g. v0.2.1); the v0.1.Xb beta series is retired, though prerelease suffixes (b, rc) remain supported by the tooling if ever needed.

See PLAN.md for what's slated for the next release.

Repo layout

SmartSDRIQStreamer.csproj          Avalonia app (root project, output: SmartStreamer4.exe)
src/SmartSDRIQStreamer.FlexRadio   FlexLib isolation (radio discovery + connection)
src/SmartSDRIQStreamer.CWSkimmer   CW Skimmer adapter (INI + launcher + telnet + sync)
tests/                             xUnit tests (CWSkimmer module)
tools/                             Diagnostic helpers (e.g. WinMM enumeration)
artifacts/                         Runtime output (logs, generated INIs, release zips)
Assets/                            Icons + screenshots referenced by the UI / docs

Documentation

File	What it covers
README.md	This file. Install, build, test, release.
SETUP_GUIDE.md	Operator guide for both modes. Embedded in the app; opens via Setup Guide on the Help tab.
ARCHITECTURE.md	Module layout, sync model, threading, conventions.
PLAN.md	Current implementation plan. What's blocking the next release and what's deferred.
CONTRIBUTING.md	Branch / PR workflow for contributors.
CLAUDE.md	Project guide for Claude Code sessions in this repo.
Flexlib4-2-Migration-Guide.md	FlexLib 4.1.5 → 4.2.18 API surface reference.

Reporting bugs

Open an issue on GitHub and include:

• SmartStreamer4 version (or commit hash)
• SmartSDR / FlexRadio firmware version
• CW Skimmer version
• Windows version
• Reproduction steps and what you expected vs. saw
• Relevant lines from artifacts/logs/streamer-status.log