https://github.com/faresbakhit/vole-sim

Vole Machine GUI Simulator For Linux, Windows, and the Web
https://github.com/faresbakhit/vole-sim

desktop-application emscripten gui imgui virtual-machine vole-machine-simulator web-application

Last synced: over 1 year ago
JSON representation

Vole Machine GUI Simulator For Linux, Windows, and the Web

• Host: GitHub
• URL: https://github.com/faresbakhit/vole-sim
• Owner: faresbakhit
• License: gpl-3.0
• Created: 2024-10-21T14:08:43.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-07T15:11:50.000Z (over 1 year ago)
• Last Synced: 2025-01-27T19:55:12.666Z (over 1 year ago)
• Topics: desktop-application, emscripten, gui, imgui, virtual-machine, vole-machine-simulator, web-application
• Language: C
• Homepage: https://faresbakhit.github.io/vole-sim/
• Size: 2.59 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# vole-sim

> Vole Machine Simulator & GUI

**Live Demo:** https://faresbakhit.github.io/vole-sim/

![](./misc/images/screenshot1.png)

Compiles & works on Linux, Windows, and the Web via WebAssembly/Emscripten.

## Building

**Dependencies**: CMake 3.5 or later and the headers and libraries for your OS and window system. SDL2 and FreeType development packages need to be installed

to build the GUI.

```sh

$ git clone --recurse-submodules git@github.com:faresbakhit/vole-sim.git

$ cd vole-sim/

$ cmake -DCMAKE_BUILD_TYPE=Release -B build/

$ cmake --build build/

$ ls build/

...

vole-sim

vole-sim-gui

```

## Materials

- [vole-isa.pdf](./materials/vole-isa.pdf): The Vole architecture and machine language specification from the appendix of the book, Computer Science: An Overview by J. Glenn Brookshear, Dennis Brylow.

- [comp-arch.pdf](./materials/comp-arch.pdf): The 2nd chapter of the same book, an introduction to concepts of computer architecture, which is required to implement a machine such as Vole.