Repository navigation
Releases
Windows alpha 0.3.0 — persistent routing and endpoint recovery
Persistent Windows routing
This release fixes two startup/relink failure modes: capture following a Windows default-device change onto the physical output, and a saved endpoint ID becoming invalid when Windows recreates a device.
- Explicit saved virtual input and physical output in Settings > Devices. Capture no longer follows Windows defaults.
- Both device IDs and exact friendly names are saved. A stale ID recovers only if exactly one active endpoint matches its saved name; the recovered ID is saved automatically. A surviving exact ID always wins. Missing or ambiguous matches require manual selection, never an arbitrary/default output.
- Same-endpoint feedback prevention remains enabled. Failed starts release WASAPI/COM resources before another attempt.
- Error dialogs now show the actual endpoint failure, including Windows HRESULTs when available, rather than only generic routing advice.
- Updated setup/upgrade documentation and packaged notices; device-selection boundary regressions run in the Windows workflow.
Upgrade / setup
Extract the entire runtime ZIP to a permanent folder and keep the Qt/plugins/CRT files together. Close the running copy before replacing it. Run Install.cmd for per-user Start Menu/Windows Search registration if needed.
After upgrading from v0.2.0 or earlier, select the virtual input once: Settings > Devices > CABLE Input (VB-Audio Virtual Cable), a playback endpoint, not recording CABLE Output. Select different physical headphones/speakers as output. If the old output already vanished before its name was saved, reselect it once too. Effects, presets, assets, and the startup preference are retained.
Route Windows default playback or desired individual apps into CABLE Input. Apps playing elsewhere bypass processing. JamesDSP does not automatically change Windows defaults. Use Relink audio pipeline after device-format changes.
Verification
Local Windows 11 x64 build and saved-device regression passed. The actual app recovered a previously missing physical output ID and a deliberately stale capture ID, persisted both, restarted using the registered sign-in command, and processed at 192000 Hz after Windows defaults were switched between cable and physical output. A coded signal sent into VB-Cable was detected in the physical output with finite float audio. The new Devices controls and recovered selection were inspected in the live GUI. No OS reboot was performed for this verification.
The runtime archive's executable matches the exercised installed binary. The complete source ZIP contains all 1973 recursively tracked files plus SOURCE_REVISION.txt, including pinned submodule sources.
Scope / limits
Still an unsigned experimental Windows WASAPI port, not a stable audio driver. VB-Cable is separate and not bundled. Missing/disabled devices and duplicate or changed friendly names can still require manual selection. This does not claim to fix independent-device clock drift, sustained DSP overload, or every intermittent/preset-related stutter. Matching endpoint rates helped original user testing but is not a universal fix.
Official upstream base remains Audio4Linux/JDSP4Linux 3ea7d733c090409c00887db3bb3aaf3af79ea692; DSP core 4.01. Release source: cc42472ba6ecd997d7c975948cb6eafcfd192270.
Windows alpha 0.2 — latest official JDSP4Linux
Latest official JDSP4Linux, native Windows port
- Official upstream:
3ea7d733c090409c00887db3bb3aaf3af79ea692. - Windows release source:
d936a415e716d824a4cbd54aab39f05c549b5d6c. - Updated official DSP engine, version 4.01, with upstream Qt 5 compatibility.
- Latest reflection-based CLI,
--relink, device/route enumeration, and route-specific automatic presets use the Windows named-pipe transport. - Preserved per-user Windows sign-in startup, Start Menu/Search registration, app icon, and second-instance handover.
- Fixed UTF-8 CLI output for non-ASCII preset names.
Install
Download JamesDSP-windows-x64.zip, extract the entire ZIP to a permanent folder, and run Install.cmd. Required Qt 5.15.2 plugins and Microsoft C++ runtime DLLs are included. Registration does not change your startup preference.
VB-Cable is a separate third-party driver and is not bundled. Set Windows default playback to the virtual cable, choose different physical headphones/speakers in JamesDSP, and match the devices' supported sample rates. The exercised Windows setup uses 192000 Hz.
JamesDSP-windows-source.zip contains complete corresponding committed source, all pinned submodule sources, licenses, and revision metadata. SHA256SUMS.txt contains the asset checksums.
Exercised verification
- MSVC 2022 x64 Release build and actual installed GUI startup with Qt removed from PATH; Qt/platform plugin/MSVC DLLs loaded app-locally.
- Live WASAPI processing: 192000 Hz, stereo 32-bit floating point, DSP core 4.01.
- A coded 997 Hz signal sent to VB-Cable was detected at the selected physical output above the existing background audio.
- Native 128-frame processing: correct -6 dB gain, 44.1/48/96/192 kHz rate transitions, every crossfeed mode, and clean teardown.
- Actual preserved Windows Run command launched a processing tray instance.
- Remote gain changes, Unicode/space/equals preset save/load/listing, and route-specific preset restoration during real pipeline relinking.
Experimental limitations
Unsigned proof of concept, not a stable audio driver. Intermittent stutter/clock drift and the previously reported DDC Church-preset slowdown are not claimed fixed by this update. Relinking and matching device sample rates remain useful troubleshooting steps. Long-duration stability and the remote CI build were not certified.
JamesDSP for Windows 0.1.0 (experimental)
Experimental Windows proof of concept
Windows 10/11 x64 target; smoke-tested on Windows 11 with VB-Cable and 192000 Hz endpoints. This is not a stable audio driver or a promise of glitch-free playback.
Install
- Download JamesDSP-windows-x64.zip and extract the entire ZIP to a permanent folder.
- Run Install.cmd to register JamesDSP in your per-user Start Menu and Windows Search. No admin rights required; Qt and app-local Microsoft C++ runtime DLLs are included.
- Install VB-Cable separately. Set Windows default playback to CABLE Input, then select different physical headphones/speakers in JamesDSP Settings → Devices.
- For sign-in startup, enable Settings → Tray icon → Start in tray when signing in to Windows. Registration alone preserves your existing startup choice. Opening JamesDSP again brings the existing tray instance forward.
- Use Relink audio pipeline in the three-dot menu after routing/sample-rate changes.
The application is unsigned; Windows may show a publisher/SmartScreen warning. Unregister-Application.ps1 removes only this copy's Start Menu/startup integration, never personal settings or application files.
Included Windows work
- WASAPI loopback capture, distinct physical output, and a same-endpoint feedback guard.
- Retained capture packets and partial output submissions rather than dropping packets when render space is smaller.
- Fixed 128-frame DSP quanta (128-frame added delay), audio-thread denormal handling, and crossfeed convolution ownership fixes.
- Explicit output selection, scrollable routing instructions, Windows sound-settings shortcut, and visible routing-start failures.
- Quoted, real executable paths in per-user startup; Start Menu/Search registration with an embedded application icon.
- Clean portable packaging, Windows build scripts/workflow, original attribution and dependency license notices.
Verified / limits
Verified actual Windows Search application result and reopening a tray instance, UI startup enable/disable, launching the real startup command, paths containing spaces, safe exact-copy unregistration, and the portable app loading bundled Qt/MSVC DLLs with Qt removed from PATH. Final live service reported 1518787, processing at 192000 Hz.
Windows processes the whole default playback mix; per-app blocklisting/allowlisting and automatic output selection are unsupported. Device clocks can drift, preset loading can stall processing, and sustained DSP overload can still stutter. Matching sample rates helped original user testing, not a universal fix. The user's exact earlier “DDC Church” selection remains unidentified; measured DDC-denormal and convolution packet-jitter problems were addressed, not every similarly named preset. Long-duration drift, lower-rate behavior and Linux runtime were not verified.
Complete corresponding source
Source commit: 1518787.
Download JamesDSP-windows-source.zip for the committed application plus every recursively pinned submodule and SOURCE_REVISION.txt. GitHub's automatically generated source ZIPs omit submodules. The patched LiquidEqualizerWidget is vendored with its original notices. Source archive contains all 1903 committed source files; Git applies Windows line-ending conversion and the upstream Versioneer export substitutions.
Build instructions are in the repository README. Root application GPLv3 and original component licenses/credits are retained. Qt 5.15.2 base/SVG/imageformats attribution and license texts are included; optional Mesa software OpenGL is not shipped. VB-Cable is not bundled.
SHA256SUMS.txt covers both download archives.