This fork was developed with the assistance of AI.
This fork adds a JIT compiler for the 3dfx Voodoo GPU pixel pipeline on ARM64 (AArch64). The upstream 86Box Voodoo emulation uses an x86-64 JIT that generates native machine code for the pixel pipeline at runtime. On ARM64 hosts (Apple Silicon, Raspberry Pi 5, Snapdragon), that JIT is unavailable and the emulator falls back to a C interpreter, which is significantly slower.
This fork ports the Voodoo JIT to ARM64, generating native AArch64 instructions for each pixel pipeline configuration — depth test, texture fetch, color/alpha combine, fog, alpha blend, dithering, and framebuffer write. The result is the same runtime code generation approach as x86-64, targeting ARMv8.0-A baseline (compatible with all 64-bit ARM devices).
- Full Voodoo pixel pipeline JIT — all 6 phases ported from x86-64 to ARM64
- macOS Apple Silicon support — W^X handling via
pthread_jit_write_protect_np, JIT entitlements - JIT debug/verify mode — optional runtime toggle to compare JIT output against the C interpreter pixel-by-pixel
This is a fork of 86Box.
86Box is a low level x86 emulator that runs older operating systems and software designed for IBM PC systems and compatibles from 1981 through fairly recent system designs based on the PCI bus.
- Easy to use interface inspired by mainstream hypervisor software
- Low level emulation of 8086-based processors up to the Mendocino-era Celeron with focus on accuracy
- Great range of customizability of virtual machines
- Many available systems, such as the very first IBM PC 5150 from 1981, or the more obscure IBM PS/2 line of systems based on the Micro Channel Architecture
- Lots of supported peripherals including video adapters, sound cards, network adapters, hard disk controllers, and SCSI adapters
- MIDI output to Windows built-in MIDI support, FluidSynth, or emulated Roland synthesizers
- Supports running MS-DOS, older Windows versions, OS/2, many Linux distributions, or vintage systems such as BeOS or NEXTSTEP, and applications for these systems
- 64-bit Intel Core 2, AMD Athlon 64 or ARMv8 processor or newer
- 4 GB of RAM or higher
- Windows version: Windows 7 Service Pack 1 or newer on Intel/AMD systems; Windows 11 or newer on ARM systems
- Linux version: Ubuntu 16.04, Debian 9.0 or other distributions from 2016 onwards
- macOS version: macOS 10.14 Mojave or newer
Performance may vary depending on host and guest configuration. Most emulation logic is executed in a single thread. Therefore, systems with greater IPC (instructions per clock) capacity should be able to emulate higher clock speeds.
For easier handling of multiple virtual machines, use a manager application:
- Avalonia 86 by notBald (Windows and Linux)
- 86Box Manager by Overdoze (Windows only)
- 86Box Manager X by xafero (Cross platform Port of 86Box Manager using Avalonia)
- sl86 by DDX (Command-line 86Box machine manager written in Python)
- Linbox-qt5 by Dungeonseeker (Linux focused, should work on Windows though untested)
- MacBox for 86Box by Moonif (MacOS only)
To use 86Box on its own, use the --vmpath/-P command line option.
See our documentation for an overview of the emulator's features and user interface.
We operate an IRC channel and a Discord server for discussing 86Box, its development, and anything related to retro computing. We look forward to hearing from you!
We welcome all contributions to the project, as long as the contribution guidelines are followed.
For instructions on how to build 86Box from source, see the build guide.
Do not use GitHub's "Sync fork" button for this fork. Use the local workflow in docs/upstream-sync-workflow.md instead:
./scripts/sync-upstream.shThis creates a dated sync branch, merges upstream/master there, and preserves known fork-owned docs such as README.md if they conflict.
86Box is released under the GNU General Public License, version 2 or later. For more information, see the COPYING file in the root of the repository.
The emulator can also optionally make use of munt, FluidSynth, Ghostscript and Discord Game SDK, which are distributed under their respective licenses.
We do not charge you for the emulator but donations are still welcome: https://paypal.me/86Box. You can also support the project on Patreon: https://www.patreon.com/86box.
