Repository navigation
Releases
WinBridge 0.4.0
The roadmap is complete: every milestone from the original plan has shipped.
New in 0.4.0
Build (M3)
winbridge package <dir>builds a real NSIS installer for your app — makensis runs under WinBridge's own managed Wine, so one pinned NSIS behaves identically on every distro. Verified end to end: installer built, run with/S, payload and uninstaller landing inC:\Program Files.- MSVC-target C/C++ via
--toolchain msvc(clang-cl + the Windows SDK fetched bywinbridge doctor --install msvc— an explicit, size-labelled opt-in, never a silent download). The cheap MinGW/Zig path stays the default. - Authenticode signing scaffolding via osslsigncode:
package --sign cert.pfx, passphrase never on a command line. winbridge doctor --install <component>bootstraps go, zig, nsis, or the MSVC SDK into your home directory — no sudo.
Run (M5)
- Compatibility recipes:
winbridge recipe show <installer.exe>fingerprints an installer and finds a community recipe (winetricks verbs, DLL overrides, DXVK);recipe applysets the app's prefix up in one step. Recipes are declarative data, strictly validated, contributable by PR — see recipes/README.md. winbridge vm app <path>streams an app that Wine cannot run from the Windows VM as a seamless window (FreeRDP RemoteApp).
Distribution and community (M6)
- Releases are now built by CI from the version tag — this release's assets were produced that way.
- Debian source packaging for the PPA, a Flatpak manifest, and
docs/distribution.mdcovering every channel. winbridge reportproduces a privacy-scrubbed hardware/compatibility report matching the hardware-report issue template — nothing is transmitted; you choose what to share. COMPATIBILITY.md seeds the community-maintained list.
Install
Debian/Ubuntu:
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.4.0/winbridge_0.4.0-1_amd64.deb
sudo apt install ./winbridge_0.4.0-1_amd64.deb
winbridge doctor
Any Linux x86-64 (no root needed):
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.4.0/winbridge-0.4.0-linux-x64.tar.gz
tar -xzf winbridge-0.4.0-linux-x64.tar.gz
install -Dm755 winbridge-0.4.0-linux-x64/winbridge ~/.local/bin/winbridge
winbridge doctor
Verify with sha256sum -c SHA256SUMS. 690 tests green; security-audited before tagging.
Guide: WinBridge on learn.dhivalabs.com: install steps, a beginner guide and troubleshooting.
WinBridge 0.3.0
M4 complete: WinBridge now covers the full run-Windows-apps launcher story.
New in 0.3.0
- DXVK —
winbridge run app.exe --dxvkrenders Direct3D 8/9/10/11 through Vulkan (DXVK 3.0.2, checksum-verified). The setting is sticky per app: enable once, every later run keeps it;--no-dxvkturns it back off.winbridge doctorreports whether a Vulkan loader is present, and--dxvkexplains itself rather than failing cryptically when one is not. - Desktop launcher entries —
winbridge desktop add app.exe --name "My App"puts the app in your desktop launcher like any native application;desktop listanddesktop removemanage the entries. Entries are ownership-marked, so removal can never touch a file WinBridge did not create. - winetricks —
winbridge prefix tricks <app> corefonts vcrun2019installs fonts, redistributables and tweaks into one app's prefix, using a tag-pinned, checksum-verified winetricks driven by WinBridge's own Wine. Note: the verbs themselves download third-party redistributables that winetricks (not WinBridge) checksums — see docs/running.md. - Prefix management —
winbridge prefix list(shows per-app DXVK state),prefix delete <app>,prefix tricks.run --list-prefixesstill works but is deprecated. - Every download WinBridge performs — Wine, DXVK, winetricks — now flows through one pinned-and-verified code path; nothing unverified is ever executed.
Install
Debian/Ubuntu:
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.3.0/winbridge_0.3.0-1_amd64.deb
sudo apt install ./winbridge_0.3.0-1_amd64.deb
winbridge doctor
Any Linux x86-64 (no root needed):
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.3.0/winbridge-0.3.0-linux-x64.tar.gz
tar -xzf winbridge-0.3.0-linux-x64.tar.gz
install -Dm755 winbridge ~/.local/bin/winbridge
winbridge doctor
Verify downloads with sha256sum -c SHA256SUMS. Full suite green in CI.
WinBridge 0.2.0
WinBridge now runs Windows apps as well as building them — the all-in-one loop on one Linux machine:
winbridge build ./myapp
winbridge run myapp/build/winbridge/windows-x64/myapp.exe
New in 0.2.0
winbridge run <app.exe>— run Windows programs on Linux. WinBridge downloads and manages its own Wine runtime (Kron4ek Wine 11.14 wow64 build, checksum-verified before it is ever unpacked; nothing runs without a verification stamp). No system Wine, no root, nothing to configure.- One isolated prefix per app under
~/.local/share/winbridge/prefixes/—--prefixto override,--list-prefixesto see them, and resetting an app is deleting one directory. - The executable is PE-verified before launch, its output streams live, and its exit code becomes
winbridge run's own. - Process handling fix: commands that leave background daemons behind (Wine's
wineserver, and anything like it) no longer hang the CLI.
First run installs the runtime (~94 MB) and bootstraps the app's prefix, which takes a few minutes once; after that, runs start in well under a second. Not yet included (next M4 slices): DXVK for Direct3D, .desktop launcher entries, winetricks recipes — see docs/running.md.
Install
Debian/Ubuntu:
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.2.0/winbridge_0.2.0-1_amd64.deb
sudo apt install ./winbridge_0.2.0-1_amd64.deb
winbridge doctor
Any Linux x86-64 (no root needed):
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.2.0/winbridge-0.2.0-linux-x64.tar.gz
tar -xzf winbridge-0.2.0-linux-x64.tar.gz
install -Dm755 winbridge ~/.local/bin/winbridge
winbridge doctor
Verify downloads with sha256sum -c SHA256SUMS.
394 tests green in CI. Building still covers Go, Rust, .NET, C/C++ natively and Flutter through the build VM.
WinBridge 0.1.0
The first release of WinBridge: build Windows apps from Linux, on any Linux.
What's included
winbridge buildcross-compiles Go, Rust, .NET, and C/C++ projects to Windows x64 — every produced artifact is byte-verified as a genuine PE32+ Windows executable before the build is reported successful.- Flutter projects build through a headless Windows VM over SSH: see docs/vm-setup.md.
winbridge vm usb list/winbridge vm usb passthroughhand USB devices to the VM so their Windows drivers can run there, andscripts/printing/bridges Windows-only printers. The honest device playbook is in docs/devices.md.winbridge doctorreports every toolchain, resolved fromPATHplus~/.cache/winbridge/toolchains— bootstrapped toolchains work without sudo.
Install
Debian/Ubuntu:
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.1.0/winbridge_0.1.0-1_amd64.deb
sudo apt install ./winbridge_0.1.0-1_amd64.deb
winbridge doctor
Any Linux x86-64 (no root needed):
curl -LO https://github.com/Dhiva-Labs/WinBridge/releases/download/v0.1.0/winbridge-0.1.0-linux-x64.tar.gz
tar -xzf winbridge-0.1.0-linux-x64.tar.gz
install -Dm755 winbridge ~/.local/bin/winbridge
winbridge doctor
Cross-compilers are resolved at run time; winbridge doctor tells you exactly what's present and what's missing.
Verify downloads with sha256sum -c SHA256SUMS.
352 tests green in CI, including end-to-end cross-compiles from all four native toolchains.