Make sure to leave a ⭐, we are getting close to 1000 😊

Hangover

This is Hangover, a project started by André Zwing and Stefan Dösinger in 2016 to run x86_64/x86_32 Windows applications on aarch64/(ppc64le)/x86_64 Wine.

1) How it works

In fact it now uses the WoW64 support in Wine + an emulator to run e.g. ARM32 on x86_64 or i386 on ARM64. This is completely different from earlier versions of Hangover, which broke out of emulation at the win32 API level.

2) Status

While the overall stability was improved, expect crashes.

3) How to build

Currently Qemu is built as a library which is used in Wine. This is a license conflict, so there'll be no binaries for download. This will change with other emulators.

3.1) Qemu

To build Qemu as a library you need:

• The dependencies to build qemu (in particular glib)
• About 1GB of disk space

Download and extract version 5.2.0 from here.

Apply the patch provided in this repo under qemu/ with:

$ patch -p1 < /path/to/your/patch

Build it like:

$ mkdir build
$ cd build
$ ../configure --target-list=arm-linux-user,i386-linux-user
$ make

In case the compiler complains about something in linux-user/ioctls.h remove the corresponding line and run make again.

Place resulting libraries in /opt (default) or set HOLIB to the full path of the resulting library.

3.2) Wine

To build Hangover Wine you need:

• The dependencies to build a 64 bit Wine
• llvm-mingw for PE cross-compilation
• About 5GB of disk space

Also make sure you have the submodule set up:

$ git submodule update --init

on x86-64:

$ mkdir -p wine/build
$ cd wine/build
$ ../configure --enable-win64 --disable-tests --with-mingw --enable-archs=i386,x86_64,arm
$ make

on ARM64:

$ mkdir -p wine/build
$ cd wine/build
$ ../configure --disable-tests --with-mingw --enable-archs=i386,aarch64,arm
$ make

4) Running

Until the critical section issue is solved it is highly recomended to limit execution to 1 core with "taskset -c 1":

on x86-64:

$ taskset -c 1 ./wine64 yourapplication.exe

on ARM64:

$ taskset -c 1 ./wine yourapplication.exe

You can add the following environment variables:

• HODLL to run applications with other dlls than xtajit or wowarmhw. e.g. HODLL=wow64cpu.dll to run it without emulation on x86-64:
  xtajit.dll for i386 emulation, wowarmhw.dll for ARM emulation and wow64cpu.dll for "native" i386 mode on x86_64
• HOLIB to set full path of the library, e.g. HOLIB=/path/to/libqemu-i386.so
• QEMU_LOG to set Qemu log channels, find some options here.

5) Todo

• Get more applications running
• Investigate CriticalSection issues (just timing?)
• Integrate other emulators than Qemu, like Box32, FEX/hex-emu

6) Donations

For anyone interested, ways to support André can be found here:

https://www.patreon.com/andre_opensource

https://liberapay.com/andre_opensource

https://flattr.com/@andre_opensource