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).
- Generally available as of v0.2.1 (2026-07-24). Latest release: see GitHub Releases.
- Requires SmartSDR 4.2.x. Built against FlexLib 4.2.20.
- Tested against SmartSDR 4.2.x server radios. SmartSDR 4.1.5 and earlier are no longer supported.
- Download
SmartStreamer4-v<version>-win-x64.zipfrom the latest GitHub Release. - Extract
SmartStreamer4.exesomewhere convenient. - 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.
Prerequisites:
- .NET 8 SDK
- Windows 10/11 (the app targets
net8.0-windows) - FlexLib API source extracted to
FlexLib_API_v4.2.20.41343/at the repo root. Download from FlexRadio: https://www.flexradio.com/software/smartsdr-v4-x-api-flexlib/
Build:
dotnet build SmartSDRIQStreamer.csprojPlain 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.csprojdotnet test tests/SmartSDRIQStreamer.CWSkimmer.TestsThe 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.
Releases are produced by publish-release.ps1, which takes exactly one of two mode flags. A tester build goes to the R2 bucket testers download from; a GA release goes to GitHub Releases. Both build and zip; neither can reach the other's destination.
# Tester build
git tag -a v0.3.3-preview1 -m "SmartStreamer4 v0.3.3-preview1" # annotated, never lightweight
git push origin main && git push origin v0.3.3-preview1
.\publish-release.ps1 -Preview # build, zip, upload to R2, print the tester link
# GA release
git tag -a v0.3.3 -m "SmartStreamer4 v0.3.3"
git push origin main && git push origin v0.3.3
# confirm RELEASE_NOTES-v0.3.3.md is finalized
.\publish-release.ps1 -Publish # build, zip, gh release create --latestBoth modes run the full test suite, publish a self-contained single-file exe, verify its embedded ProductVersion matches <tag>+<sha>, Authenticode-sign it and verify the signature (every build is signed, with no unsigned fallback; see CODE-SIGNING.md), and zip it as SmartStreamer4-<tag>-win-x64.zip together with THIRD-PARTY-NOTICES.txt. The project's own LICENSE is deliberately not packaged: it is extensionless, so Windows will not open it from the extracted folder, and we hold the copyright, so its omission carries no external obligation.
Both modes refuse a dirty working tree, because the build comes from the working tree rather than the tagged commit. -Preview requires a vX.Y.Z-previewN tag, uploads the zip to the download bucket, and verifies the published URL answers with the expected size; a re-run of the same tag overwrites it. -Publish requires a clean vX.Y.Z tag, fails fast before building if the tag is missing from origin or points at a different commit there or the notes file is empty, writes the bare SHA256SUMS.txt, and creates the GitHub release with the zip and sidecar attached (browsers block .exe downloads, so always ship the zip). Nothing is committed either way, so the release commit equals the tag commit. --latest is hard-coded and --prerelease is not exposed.
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). Numbered tester builds are tagged vMAJOR.MINOR.PATCH-previewN (e.g. v0.3.3-preview1), distributed to testers from the download bucket, and never published as GitHub releases. The v0.1.Xb beta series is retired.
See PLAN.md for what's slated for the next release.
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
| 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. |
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