hangover - GitLite

KO | EN

gitlite — search

#python #react #ai #llm #golang #rust #linux #docker #java #cli #kubernetes #vue #security #mcp

hangover

(★ 2,016)

Hangover runs Win64 and Win32 applications on arm64 Linux

File Explorer

Download Latest Version (.zip)

- - issue.yml
- - deb.yml
- - Dockerfile
- - Dockerfile
- - Dockerfile
- - Dockerfile
- - Dockerfile
- - Dockerfile
- - benchmarks.csv
  - dhry164int64.exe.png
  - dhry264int64.exe.png
  - linpack64.exe.png
- - benchmarks.csv
  - dhry164int64.exe.png
  - dhry264int64.exe.png
  - linpack64.exe.png
- - 04-P4P.exe.1.png
  - 04-P4P.exe.2.png
  - benchmarks_ycruncher.csv
  - benchmarks_yquake2.csv
  - yquake2.exe.png
- readme.md
- COMPILE.md
.gitignore
.gitmodules
box64
fex
LICENSE
README.md
wine

# Installation Guide

1. Get the code

git clone https://github.com/AndreRH/hangover

Downloads the entire project code from GitHub to your computer.

cd hangover

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

docker build -f .packaging/debian12/Dockerfile -t hangover .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 hangover

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[español](https://github-com.translate.goog/AndreRH/hangover/blob/master/README.md?_x_tr_sl=en&_x_tr_tl=es) | [français](https://github-com.translate.goog/AndreRH/hangover/blob/master/README.md?_x_tr_sl=en&_x_tr_tl=fr) | [português](https://github-com.translate.goog/AndreRH/hangover/blob/master/README.md?_x_tr_sl=en&_x_tr_tl=pt) | [deutsch](https://github-com.translate.goog/AndreRH/hangover/blob/master/README.md?_x_tr_sl=en&_x_tr_tl=de)

---

![stars](https://img.shields.io/github/stars/AndreRH/hangover?style=flat-square)
![forks](https://img.shields.io/github/forks/AndreRH/hangover?style=flat-square)
![Release](https://img.shields.io/github/v/release/AndreRH/hangover?style=flat-square)

Make sure to leave a :star: :)

## Hangover
This is Hangover, a project started by André Zwing and Stefan Dösinger in 2016 that can
run x86_64 and x86_32 Windows applications on aarch64 Wine.

### How it works
Hangover uses emulator DLLs to emulate only the application you want to run, rather than an entire Wine installation. It does not require 32-bit Unix libraries, and you can also run applications natively without emulation (like ARM64 7-Zip on ARM64).

As soon as the application does a Windows/Wine system call, say NtUserCreateWindowEx, it's executed outside the emulator (read non-emulated, fast, native). Even better, everything Unix related is never emulated.

In short, we break out of emulation at the win32 syscall or wine unix call level for performance reasons, which is enabled by the WoW64 support in Wine.

For 64-Bit we're using the ARM64EC ABI combined with an emulator (FEX).

### Benchmarks
For Benchmarks see [here](benchmarks/readme.md). They show that the Hangover approach works as expected, as only emulating the application instead of a complete Wine installation has benefits. It's especially visible with box64cpu vs. Wine running under Box64.

### Interesting Branches

* [RISC-V 64-bit Linux support](https://github.com/AndreRH/hangover/tree/riscv64)
* [Hangover-WOW64](https://github.com/AndreRH/hangover/tree/wow) (Hangover 0.8.1 - 9.19)
* [Hangover-Classic](https://github.com/AndreRH/hangover/tree/hangover-classic) (Hangover 0.4.0 - 0.6.5)

### Status
Current main focus is to run x86_64 and i386 Windows applications on ARM64 Linux, but it's also possible to run ARM32 Windows applications on x86_64 Linux.

PPC64le isn't supported anymore and won't be added back in the near future.
If you need that feature, have a look at older releases before 0.8.x.

Emulator integrations:

- [QEMU](https://gitlab.com/qemu-project/qemu): Removed
- [FEX](https://github.com/FEX-Emu/FEX): Upstream PE version plus some conveniences
- [Box64](https://github.com/ptitSeb/box64/): Upstream PE version
- [Blink](https://github.com/jart/blink): started, not part of this repository yet

### Discord
A Discord Server is available for contributors and previous financial supporters (see "Financial Contributiors" below).
It provides advanced user support, development discussions and more.

### Packages
__Debian__ 11 & 12 & 13 (also usable for Raspbian, Armbian, ...) and __Ubuntu__ 20.04 & 22.04 & 24.04 & 25.10 are attached to the Github Release.
Install them with
```bash
$ sudo apt install ./hangover*.deb
```

__Termux__ packages can be found in the [Termux Repository](https://github.com/termux/termux-packages/tree/master/x11-packages/hangover-wine).

### How to build
For build instructions see [here](docs/COMPILE.md).

### Running
You can add the following environment variables:

* HODLL64 to select the 64-bit emulator dll:
    * libarm64ecfex.dll for x86_64 emulation (FEX)
    * xtajit64.dll (Wine stub dll)
* HODLL to select the 32-bit emulator dll:
    * wow64cpu.dll for "native" i386 mode on x86_64
    * libwow64fex.dll for i386 emulation (FEX)
    * wowbox64.dll for i386 emulation (Box64)

#### FEX
libarm64ecfex.dll currently is the default for x86_64 emulation, so it's simply:

```bash
$ wine your_x86_64_application.exe
```

libwow64fex.dll is not the default for i386 emulation, so you need:

```bash
$ HODLL=libwow64fex.dll wine your_x86_application.exe
```

#### Box64
wowbox64.dll currently is the default for i386 emulation, so it's simply:

```bash
$ wine your_x86_application.exe
```

If you have issues with the default, please try one of the other emulators below.

#### Enabling Wayland
Wayland isn't used by default or automatically, but if you want to use it instead of X11 do:

```bash
$ wine reg.exe add HKCU\\Software\\Wine\\Drivers /v Graphics /d wayland,x11
```

#### DXVK
Copy the x32 binaries to $WINEPREFIX/drive_c/windows/syswow64

Copy the arm64ec, aarch64 or x64 binaries to $WINEPREFIX/drive_c/windows/system32, depending on your use case.
For x86_64 applications first try arm64ec, it should perform best. In case it doesn't work, try x64. For aarch64 applications use aarch64.
Then open `winecfg`, switch to the Libraries tab and add `native` DLL overrides for `d3d8`, `d3d9`, `d3d10core`, `d3d11` and `dxgi`.

Note that DXVK requires a Vulkan 1.3 driver with certain features and that might not be the case for a lot of ARM64 hardware.

### Financial Contributors

I have decided to end my activities on Patreon and other platforms.
It won't be the end of the project, my plan is to keep working on it,
delivering new releases and updates. However, I will invest less time,
except for the RISC-V port.