tinyemu/README.md

TinyEMU System Emulator

This repo is a fork of Fabrice Bellard's TinyEMU project, a lightweight RISC-V and x86 emulator. Specifically migrating the project to the latest stable release of enscriptem. I provide a flake.nix dev shell too (cause I'm super nice).

Compiling

Nix

nix develop
makejs # alias for `make -f Makefile.js`
make

Note

emscripten expects an FHS so I've instead implemented a shell hook to steal copy ${pkgs.emscripten}/share/emscripten/cache prior to makejs. Refer to https://github.com/NixOS/nixpkgs/issues/139943

Not Nix

make -f Makefile.js
make

Tip

The following dependencies are required for compilation, the version numbers are what I compiled against but are not strict.

1. make [v4.4.1] (aka gnumake)
2. emscripten [v4.0.8]
3. SDL [v1.2.68] (aka libsdl)
4. curl [v8.14.1]
5. openssl [v3.4.1]