shrimp

main branch1 version
  • main branchlatestJun 21, 2026

github.com/DanielGilchrist/shrimp

CHIP-8 Interpreter (WIP)

0 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  shrimp:
    github: DanielGilchrist/shrimp
    branch: main

main is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
>= 1.16.1
License
MIT
Author
Daniel Gilchrist
Target
  • shrimp from src/shrimp.cr

Dependencies

Runtime Dependencies

  • sdl*github: ysbaddaden/sdl.cr
  • web*github: lbguilherme/crystal-web
  • kebab*github: DanielGilchrist/kebab, branch: main

README

shrimp

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

Native using SDL

WASM in the browser

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.

Documentation

Read the API docs

Built from the current release. The first visit to a release nobody has asked for starts its build.

Links

This branch

Branch
main
Seen
Jun 21, 2026
Crystal
>= 1.16.1
Indexed
yes

Dependents

No indexed shard depends on this one yet.

Repository

github.com/DanielGilchrist/shrimp

Metadata

Created
Aug 12, 2026
Updated
Aug 14, 2026
Synced
Aug 14, 2026
Versions
1