tinyemu/README.md

TinyEMU System Emulator

This repo is a fork of Fabrice Bellard's TinyEMU project [v2019-12-21], 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).

This repo will mostly be a guide for embedding TinyEMU into your website (cause that's what I'm doing).
PS: there is no guide for Windows because I'm allergic and it scares me.

For WAYYYY more information I've provided Bellard's original tinyemu/readme.txt & jslinux/readme.txt files

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

Other Unix Systems

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/SDL-devel)
4. curl [v8.14.1] (aka libcurl-devel)
5. openssl [v3.4.1] (aka openssl-devel)

Todo

1. Expose the CONFIG_FS_NET + CONFIG_SDL Makefile variables