Skip to content
AdvDebugPublic

About

Run Windows and Linux programs on Windows, Linux and Android. A user-mode NT and Linux kernel emulator with WHP/KVM acceleration.

Topics

Resources

Contributing

Stars

174 stars

Watchers

3 watching

Forks

Repository files navigation

Brovan. Run Windows and Linux programs on Windows, Linux and Android.

Play games, try untrusted programs safely, and see everything they do.

Build License

Get started  ·  For researchers  ·  FAQ  ·  Wiki


Hollow Knight: Silksong in Brovan
Hollow Knight: Silksong
Lethal Company in Brovan
Lethal Company
ULTRAKILL in Brovan
ULTRAKILL
Left 4 Dead 2 in Brovan
Left 4 Dead 2
A Short Hike in Brovan
A Short Hike
vkQuake in Brovan
vkQuake

Real captures from Brovan on Windows Hypervisor Platform. How well a game runs varies, so check the FAQ.

What is Brovan?

Brovan runs Windows programs and games in a sandbox, on Windows, Linux and Android.

Play
Windows games on your own GPU, even on Android.
Get started
Try safely
Programs cannot change your files or go online unless you let them.
How the sandbox works
Analyze
See every system call and API call, and stop or change any of them.
For researchers

Note

Brovan is in early development. Many games and programs run, and some do not yet. If something breaks, check the FAQ or open an issue.

Get started

On Windows and Linux

  1. Download Brovan for Windows or Linux from the latest build.
  2. Extract it and open BrovanGUI.
  3. Open Setup and click Install the latest next to DXVK, which most games need. On Linux, also pick a Windows 11 ISO there. Brovan takes the Windows system files from it.
  4. Click + next to Library, choose the game's .exe, and click Launch.

The BrovanGUI launcher

Make games run faster

On Windows, Brovan runs much faster with Windows Hypervisor Platform, which is part of Windows but off by default.

  1. Open the Start menu, type Turn Windows features on or off and open it.
  2. Tick Windows Hypervisor Platform, click OK, and restart.

If BrovanGUI still says it is not available, turn on virtualization (Intel VT-x, AMD-V or SVM) in your PC's BIOS. On Linux, Brovan uses KVM, and your user needs access to /dev/kvm.

On Android

Install the APK from the latest build, open the app and follow its setup. One step asks for a Windows ISO on your phone and imports the system files from it. The app can open Microsoft's download page if you need one.

No, I'm Not a Human running in Brovan on an Android phone, with on-screen controls
No, I'm Not a Human on a Pixel 7, with Brovan's on-screen controls

For researchers

Brovan works at the system call level. The real Windows DLLs run inside the guest, and Brovan implements the NT kernel, win32k and the system services under them, so every call into the kernel can be traced, stopped or changed.

  • Debugger: conditional breakpoints, read/write/execute watchpoints, stepping and snapshots
  • Tracing: live system call and API call traces, exported to JSON, CSV or text
  • Control: rules that allow, deny or rewrite system calls, and ghost patches the program cannot see
  • Network: traffic capture to PCAP, with loopback-only access by default
  • Inputs: 64-bit and 32-bit PE, 64-bit ELF, memory dumps and raw shellcode
  • Backends: Unicorn on any host, with the full analysis toolset, or WHP on Windows and KVM on Linux for speed

Brovan stopped at a breakpoint on NtCreateFile
A breakpoint on ntdll!NtCreateFile, with the disassembly at that address

API calls and system calls traced live
API calls and system calls, traced live

The wiki documents the commands, including scripting from the command line, and the architecture. The FAQ explains the sandbox and how Brovan compares to other tools.

Contributing

Bug reports, fixes and new system calls are all welcome. CONTRIBUTING.md shows where to start and how to build Brovan.

Credits

Thanks to my friends GittingHubbers for help with the MLFQ scheduler, and Adam (Zypherion Technologies) for help with various parts of the emulator.

License

Brovan is licensed under the MIT License.

The Unicorn patches in Brovan/native/unicorn are GPL-2.0, like Unicorn itself. Brovan's releases include Unicorn, so a release as a whole is distributed under the GPL-2.0, but Brovan's own code in it stays MIT and can be reused under MIT without Unicorn.

About

Run Windows and Linux programs on Windows, Linux and Android. A user-mode NT and Linux kernel emulator with WHP/KVM acceleration.

Topics

Resources

Contributing

Stars

174 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages