Skip to content

Repository files navigation

LSW

LSW - Linux Subsystem for Windows Development

CI crates.io docs license msrv

Build, run, debug, and ship Windows software without leaving Linux.

$ lsw setup
Detected CMake project 'hello'
Created environment 'windows-x64' (llvm-mingw 22.1.8, wine 11.13)

$ lsw run
Hello from LSW

$ lsw check
  + build            1 artifact(s) via CMake
  + wine execution   1 test(s) passed under wine
  + dependencies     all DLL imports resolved
  + hardening        ASLR + DEP enabled
all checks passed

lsw build makes a genuine Windows PE binary from your CMake, Meson, Cargo, Zig, Make, or .NET project. lsw run starts it through Wine. lsw test, lsw debug, and lsw package complete the loop, and lsw verify --native runs the result on a real Windows host - LSW never reports a Wine pass as a Windows pass.

Install

cargo install lsw && lsw install

You also need Wine, a MinGW-w64 or llvm-mingw toolchain, and your build system. lsw doctor names anything missing.

Documentation

All documentation is at johnqherman.github.io/LSW: installation, quickstart, guides for every workflow, the full command reference, the lsw.toml schema, and the error catalogue.

Security model and vulnerability reporting: SECURITY.md. Contributing: CONTRIBUTING.md.

License

Apache-2.0 OR MIT.

About

Build, run, inspect, debug, package, and verify Windows applications from Linux.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Used by

Contributors

Languages