Skip to content
Box86 - Linux Userspace x86 Emulator with a twist, targeted at ARM Linux devices
Branch: master
Clone or download
ptitSeb Merge pull request #13 from M-HT/fixes
New instructions and other fixes
Latest commit 37961f5 Mar 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
tests Working on fork, with test. Jan 19, 2019
.gitignore
CHANGELOG.md
CMakeLists.txt Revert to before SIMD Evrywhere. It's slower then before and also hav… Mar 20, 2019
COMPILE.md
LICENSE
README.md Let's be less dramatic in the README Mar 21, 2019
USAGE.md Added option to load PIE Program at a specific address (to help debug… Mar 18, 2019
rebuild_wrappers.py
runTest.cmake More instruction, with fixes. printf is working now, and so is test04 Dec 22, 2018

README.md

box86

Linux Userspace x86 Emulator with a twist

Box86 will let run x86 Linux program (games) on non-x86 Linux, like ARM (needs to be 32bits little-endian).

Also, Box86 use native version for some "system" libraries, like libc, libm, or SDL and OpenGL, leading to more performance and easier integration with host system.

Most x86 Games needs OpenGL, so on ARM platform, a solution like gl4es is probably needed.

Note that current version of Box86 doesn't feature any form of JIT/Dynarec: expect everything to be slow.

Current version is still experimental, so some stuff still wont run. But many do works, like for example, WorldOfGoo (at least on the Pandora), Airline Tycoon Deluxe or new FTL. Many of the GameMaker linux game also runs fine.

If you are serious about developping Box86, you should install ccache and activate it's support in the cmake project (use ccmake for example) To have the TRACE enabled (i.e. dumping to stdout all individual x86 instruction execute, with dump of registers), you'll also need Zydis library accessible on your system.

Some x86 internal opcode use parts of "Realmode X86 Emulator Library", see x86primop.c for copyright details

Here are 3 videos, one of "Airline Tycoon Deluxe" running on an gigahertz OpenPandora, and the other 2 of "Bit.Trip.Runner" and "Neverwinter Night" running on an ODroid XU4.

Play on Youtube Play on Youtube Play on Youtube


Compiling

How to compile can be found here


Usage

There are a few environnement variable to control Box86 behavour.

See here for all variables and what they do.


Version history

The change log is here

(If you use Box86 in your project, please don't forget to mention Box86)

You can’t perform that action at this time.