package

github.com/DanielGilchrist/shrimp

main / published Jun 21, 2026 / repository

CHIP-8 Interpreter (WIP)

shrimp

Name unrelated, just having fun building a CHIP-8 interpreter

Native using SDL

image

WASM in the browser

image

Running locally

  1. Install SDL2
  2. shards install
  3. crystal run src/shrimp.cr --release -- --rom="/path/to/rom"

WASM

The interpreter can also be compiled to web assembly and run in the browser. This can be viewed at https://danielgilchrist.github.io/shrimp.

To compile to WASM and run the interpreter locally in your browser simply run the below script:

scripts/run_wasm_local.sh

Note: You will need python3 (local web server to get around CORS issues with .wasm files on localhost) and docker installed.

API