https://github.com/TheInvader360/chip8

:video_game: Chip-8 emulator (golang)
https://github.com/TheInvader360/chip8

chip8 chip8-emulator chip8-interpreter ebiten emudev emulation emulator go golang interpreter

Last synced: about 2 months ago
JSON representation

:video_game: Chip-8 emulator (golang)

• Host: GitHub
• URL: https://github.com/TheInvader360/chip8
• Owner: TheInvader360
• Created: 2020-06-23T23:25:29.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-07-04T00:28:27.000Z (over 4 years ago)
• Last Synced: 2024-08-03T23:29:26.385Z (5 months ago)
• Topics: chip8, chip8-emulator, chip8-interpreter, ebiten, emudev, emulation, emulator, go, golang, interpreter
• Language: Go
• Homepage:
• Size: 4.39 MB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

• awesome-golang-repositories - chip8 - 8 emulator (golang) (Repositories)

README

        
# CHIP-8 [![Build Status](https://travis-ci.com/TheInvader360/chip8.svg?branch=master)](https://travis-ci.com/TheInvader360/chip8)

:video_game: [CHIP-8](https://en.wikipedia.org/wiki/CHIP-8) emulator written in [Go](https://golang.org/).

## Local Setup

[Download](https://golang.org/dl) and [install](https://golang.org/doc/install) Go, then install dependencies:

    sudo apt install libc6-dev libglu1-mesa-dev libgl1-mesa-dev libxcursor-dev libxi-dev libxinerama-dev libxrandr-dev libxxf86vm-dev libasound2-dev pkg-config

Clone and run:

    git clone https://github.com/TheInvader360/chip8

    cd chip8

    go test ./... && go run main.go -path=./rom/test/ti360.ch8

Command line options:

    -path string : path to rom file (default "./rom/test/ti360.ch8")

    -clock int   : cpu clock speed in hz (100-2000) (default 400)

    -debug       : enable debug info in terminal

    -fullscreen  : enable fullscreen mode

    -height int  : height of client screen in pixels (default 320)

    -width int   : width of client screen in pixels (default 640)

Example launch commands:

    go run main.go

    go run main.go -path=./rom/chip8/BRIX.ch8

    go run main.go -path=./rom/chip8/BLINKY.ch8 -clock=1000

    go run main.go -path=./rom/chip8/CAVE.ch8 -clock=300 -debug

    go run main.go -path=./rom/chip8/PONG.ch8 -clock=500 -fullscreen

    go run main.go -path=./rom/chip8/UFO.ch8 -width=1280 -height=640

    go run main.go -path=./rom/chip8/WALL.ch8 -clock=300 -debug -width=640 -height=480

    go run main.go -path=./rom/schip/DRAGON1.ch8 -debug -clock=2000

    go run main.go -path=./rom/schip/JOUST23.ch8 -debug -clock=2000

## Input

Mapping CHIP-8 keys to a QWERTY keyboard:

    CHIP-8:     QWERTY:

    1 2 3 C     1 2 3 4

    4 5 6 D     Q W E R

    7 8 9 E     A S D F

    A 0 B F     Z X C V

Additional controls:

    P   - Pause or unpause emulation loop

    O   - One iteration of the emulation loop (step through while paused)

    I   - Initialize (reset to a clean starting state)

    Esc - Exit