Home

Awesome

Halfix x86 emulator

Halfix is a portable x86 emulator written in C99. It allows you to run legacy operating systems on modern platforms.

Why?

I made this mostly for fun, and because it was a great way to learn about the x86 PC architecture. On a more practical level, it can be used for:

Building and Running

You will need node.js, a C99-compatible compiler, zlib, and Emscripten (only if you're targeting the browser). Make sure that the required libraries are in a place where the compiler can find them. No pre-build configuration is required.

The display driver uses libsdl, but if you're on Windows, there's a native port that uses the Win32 API and doesn't require SDL.

# Debug, native
node makefile.js
# Debug, Emscripten, asm.js
node makefile.js emscripten
# Debug, Emscripten, WebAssembly
node makefile.js emscripten --enable-wasm

# Release, native
node makefile.js release
# Release, Emscripten, asm.js
node makefile.js emscripten release
# Release, Emscripten, WebAssembly
node makefile.js emscripten --enable-wasm release

# Win32 API build (no SDL required)
node makefile.js win32
# Win32 API build, release
node makefile.js win32 release

# For more options and fine tuning
node makefile.js --help

# Chunk an image 
node tools/imgsplit.js os.img

# Run in browser
http-server

Check the project wiki for more details.

System Specifications

Compatibility

It boots a wide range of operating system software, including all versions of DOS, most versions of Windows (excluding Windows 8), newer versions of OS/2 Warp (3 and 4.5), ReactOS, some varieties of Linux (ISO Linux, Damn Small Linux, Red Star OS 2, Buildroot, Ubuntu), 9Front, NeXTSTEP, several hobby OSes, and probably more.

See Compatibility for more details.

Self-Virtualization

Can you run the emulator inside the emulator?

Yes, but not very quickly.

Halfix in Halfix

Screenshots

MS-DOS

DOS

OS/2 Warp 4.5

OS/2 Warp

Windows Vista

Vista

Windows 7

Windows 7

The same Windows 98 disk image as in the Halfix in Halfix screenshot running in Firefox

Win98

CPU-Z on Windows XP

CPU-Z

Windows 10

Win10

Ubuntu

Ubuntu

Transferring Files

Create a directory with all the files you want to transfer and create an ISO image.

mkisofs -o programs.iso -max-iso9660-filenames -iso-level 4 programs/

Now update the configuration file as follows:

# Note: it does not hae to be ata0-slave. 
# I have not tested it with anything but ata0-slave.
[ata0-slave]
inserted=1
type=cd
file=/tmp/programs.iso
driver=sync

Now boot up your operating system and copy the files from the CD-ROM to the hard drive.

Known Issues

License

GNU General Public License version 3

Similar Projects

Credits

The FPU emulator uses an modified version of Berkeley SoftFloat from the Bochs emulator.