ptitSeb / box64

Box64: Linux Userspace x86-64 Emulator with a Twist Website | Changelog | 中文 | Українська | Report an Error --- **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. _Logo and icon by @grayduck - Thank you!_ --- Usage• to run Linux x86_64 programs.• to kill all the emulated processes.• 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** • Box32 is still experimental.• Some shell scripts (such as the GOG game installer) may rely on to determine the current architecture. Please run them as to allow Box64 to take over. --- Configuration Box64 has configuration files located in and , both formatted as files. If you don’t want to use the default file, copy it to to ensure compatibility. Settings priority: > > Command line. For more information, check Usage Documentation. --- Additional Platform-Specific Notes Unity Game Emulation• Many Unity games require OpenGL 3+, which may be challenging on ARM/RISC-V SBCs.• **Tip for Pi4 and Pi5 Users**: Set with to prevent freezes and enable strong memory mode.• **Using Panfrost**: For better compatibility on ARM, enable to force higher OpenGL profiles. This can help if a game starts but quits unexpectedly before showing any content. Steam See Steam Documentation. Wine Box64 supports Wine64 and Proton. For 32-bit components, Box86 is required. Systems with both Box64 and Box86 can run 32- and 64-bit Windows programs. **Note**: You can use Wine WOW64 build to run x86 Windows programs in Box64-only environments, this is still experimental, but it works in most cases. For more information, check Wine Documentation. ---- Final word ---- I want to thank everyone who has contributed to box64 development. There are many ways to contribute: code contribution, financial, hardware and advertisement! So, in no particular order, I want to thank:• For their major code contribution: rajdakin, mogery, ksco, xctan• For their major financial contribution: Playtron, tohodakilla, FlyingFathead, stormchaser3000, dennis1248, sll00, libre-computer-project, CubeCoders Limited• For hardware contribution and LoongArch migration: xiaoji, Deepin Beijing Develop Team• For their hardware contribution: ADLINK with Ampere, SOPHGO, Radxa, StarFive, Pine64, AYN, AYANEO, jiangcuo• For their continuous advertisements for the box64 project: salva (microLinux), PILab/TwisterOS team, The Byteman, NicoD, ekianjo (Boilingsteam) And I also thank the many other people who participated even once in this project. (If you use Box64 in your project, please don't forget to mention it!)