wibo

A minimal, low-fuss wrapper that can run simple command-line 32-bit Windows binaries on Linux and macOS - developed to run Windows compilers faster than Wine.

Download the latest release from GitHub releases or build from source.

Available builds:

• wibo-i686: Linux x86 (static binary)
• wibo-x86_64: Linux x86_64 (static binary, experimental)
• wibo-macos: macOS x86_64 (experimental, Rosetta 2 supported)

Building

cmake --preset debug
cmake --build --preset debug

This will produce an x86 (32-bit) debug Linux binary at build/debug/wibo.

Available presets:

• debug: Debug Linux x86
• release: Release Linux x86
• debug64: Debug Linux x86_64
• release64: Release Linux x86_64
• debug-macos: Debug macOS x86_64
• release-macos: Release macOS x86_64

Usage

wibo [options] <program.exe> [arguments...]
wibo path [subcommand options] <path> [path...]

General Options

Runtime Options

Subcommands

Examples

Normal usage

wibo path/to/test.exe a b c
wibo -C path/to test.exe a b c

Advanced: full control over the guest command line

wibo path/to/test.exe -- test.exe a b c
wibo --cmdline 'test.exe a b c' path/to/test.exe
wibo -- test.exe a b c

Tests

Self-checking Windows fixtures run through CTest. They require a 32-bit MinGW cross toolchain (i686-w64-mingw32-gcc and i686-w64-mingw32-windres).

On macOS: use brew install mingw-w64.

ctest --preset debug

This will cross-compile the fixture executables, run them through wibo, and fail if any WinAPI expectations are not met.

Related Projects

• taviso/loadlibrary - Initial inspiration for this project.
• evmar/retrowin32 - A similar project with different goals and architecture.
• decomp.me - Collaborative decompilation website; uses wibo to run Windows compilers.

License

wibo is licensed under the MIT License. See LICENSE for details.

Optionally, wibo embeds custom Wine CRT DLL builds from encounter/winedll. To disable, set -DWIBO_ENABLE_WINE_DLLS=NO.

Wine is licensed under the LGPLv2.1+. See winedll/LICENSE and winedll/COPYING.LIB for details.