ptitSeb /box64

Box64 - Linux Userspace x86_64 Emulator with a twist, targeted at ARM64, RV64 and LoongArch Linux devices

★ 5,715⑂ 490👁 78⑃ 3,005● 1,575▤ 22
CMITCreated 2020-12-01box86.org
Download: v0.4.4v0.4.4 ↓0.4.42026-08-02
+1
Daily
5,715
stars
490
forks
78
watchers
3,005
prs
1,575
issues
22
releases

README

!Official logo

 Box64: Linux Userspace x86-64 Emulator with a Twist

Website | Changelog | 中文 | Українська | Report an Error

!Build Status !Stars !Forks !Contributors !Pull Requests !Issues

---

Check out our game compatibility list at https://box86.org/app/, please help us improve it!

---

Box64 enables running x86_64 Linux programs, including games, on non-x86_64 Linux systems such as Arm (64-bit little-endian host system required).

Box64 leverages native system libraries (libc, libm, SDL, OpenGL), offering ease of integration and surprising performance in many applications. For performance benchmarks, check this analysis.

With DynaRec for Arm, RISC-V and LoongArch platforms, Box64 achieves a speed boost 5-10x faster than the interpreter alone. For a deeper look at DynaRec, see Inner workings. For a more detailed look at Box64 internals and optimization strategies, see our EuroSys 2026 paper, Practical and Efficient x86-64 Emulation on RISC-V, which focuses on RISC-V but covers many techniques that apply more broadly to Box64.



_Logo and icon by @grayduck - Thank you!_

---

 Usage

- $ box64 ./program [args] to run Linux x86_64 programs.
- $ box64 -k to kill all the emulated processes.
- $ box64-bash to have an x86_64 bash environment.
- Want to use wine? see Wine Documentation.

Box64 also offers environment variables and rcfile to control its behavior. For details, see Usage Documentation.

---

 Compiling and Installation

- Compilation Instructions
- Bundle x86 Libraries
- Wine Installation for Box64

---

 Version History

See the Changelog for version updates.

---

 Platform Compatibility Notes

Box64 requires 64-bit libraries on the host system, as it directly translates x86_64 function calls. For 32-bit binaries, use Box86 or Box32.

Notes 

1. Box32 is still experimental, but it's pretty stable now and can be used.
2. Some shell scripts (such as the GOG game installer) may rely on uname -m to determine the current architecture. Please run them as box64 script.sh to allow Box64 to take over.

Note that DynaCache is now enabled by default (with compression). This will creates files in ~/.cache/box64 to save generated code for executed binaries and libraries, so launch time can be greatly reduced on second run. The files are compressed and will take up to 2Gb by default. You can disable DynaCache writing, by switching it to a Read-only mode by creating (or modifying) ~/.box64rc and writing there

ini
[]
BOX64_DYNACACHE=2


(or 0 to completely disabled it). Please refer to Usage Documentation for more details on how to configure Box64.

---

 Configuration

Box64 has configuration files located in /etc/box64.box64rc and ~/.box64rc, both formatted as .ini files. If you don’t want to use the default /etc/box64.box64rc file, copy it to ~/.box64rc to ensure compatibility.

Settings priority: ~/.box64rc  /etc/box64.box64rc  Command line.

For more information

Top issues

Discussions

Latest release

v0.4.4 v0.4.4 2026-08-02
What's Changed
 A new box64-configurator is now present (a python app) to help managing custom RCFILE profiles. It is available in both english and chinese.
 DynaCache is now enabled by default. It will compress the files and use up to 2GB of disk space.
 You can use box64-configurator on the special [] profile to change default values
 More improvements on emulation accuracy that help running more DRM'd games
 Many Speed improvements in the LoongArch backend
 Many new opcodes in the RISC-V backend

More details in New release blog

 Contributions
 [DYNAREC] Optimized native_pclmul 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON