emileclarkb/tinyemu
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
TinyEMU is a system emulator for the RISC-V and x86 architectures. Its purpose is to be small and simple while being complete.
23 commits 1 branch 0 tags 387 KiB
Find a file
Emile Clark-Boman c4af0d085c Moved all *.c|*.h files to src/
2025-07-22 08:05:36 +10:00
js Fork http://bellard.org/tinyemu 2025-07-22 02:42:34 +10:00
src Moved all *.c|*.h files to src/ 2025-07-22 08:05:36 +10:00
.gitignore GCC artifacts now isolated to build/ & bin/ 2025-07-22 07:03:54 +10:00
Changelog Fork http://bellard.org/tinyemu 2025-07-22 02:42:34 +10:00
flake.lock Added (90%)template flake based nix development shell 2025-07-22 02:59:46 +10:00
flake.nix Move flake.nix issues/139943 Ref 2025-07-22 04:50:53 +10:00
Makefile Makefile now supports src/ path 2025-07-22 08:04:24 +10:00
Makefile.js Removed emscriptem opt "-s BINARYEN_TRAP_MODE=clamp" (default for WASM compile target) 2025-07-22 03:24:52 +10:00
MIT-LICENSE.txt Fork http://bellard.org/tinyemu 2025-07-22 02:42:34 +10:00
netinit.sh Fork http://bellard.org/tinyemu 2025-07-22 02:42:34 +10:00
README.md README.md emphasis on allergy with <br/> 2025-07-22 04:49:02 +10:00
readme.txt Fork http://bellard.org/tinyemu 2025-07-22 02:42:34 +10:00
VERSION Modified version number 2025-07-22 08:04:59 +10:00

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).

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 read Bellard's original readme.txt

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)
  4. curl [v8.14.1]
  5. openssl [v3.4.1]