https://github.com/0xnathanw/chip-8

A Chip8 emulator built in Go.
https://github.com/0xnathanw/chip-8

chip-8 chip8 emulator go golang tcell terminal tui

Last synced: about 2 months ago
JSON representation

A Chip8 emulator built in Go.

• Host: GitHub
• URL: https://github.com/0xnathanw/chip-8
• Owner: 0xNathanW
• Created: 2021-09-28T00:37:45.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-06-08T17:19:18.000Z (7 months ago)
• Last Synced: 2024-06-08T18:35:18.556Z (7 months ago)
• Topics: chip-8, chip8, emulator, go, golang, tcell, terminal, tui
• Language: Go
• Homepage:
• Size: 3.75 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# **Chip-8** #

Chip-8 is a very basic interpreted programming language written for computers in the 1970's, mainly for writing games.

This is an implementation of a virtual machine for Chip-8 written in Go.  It loads and runs programs, and allows users to pause and step through individual opcodes.  Users can also set their own colour configs.

## Demo ##

[![asciicast](https://asciinema.org/a/GCeqUwVQ1ZU8Q4uppy2bi1AsE.svg)](https://asciinema.org/a/GCeqUwVQ1ZU8Q4uppy2bi1AsE)

## Installation ##

To install, clone the repository with git, and build with `go build`.

ROMs can be added by adding them to the 'ROMs' folder.  Note this folder is required for the program to read from.

## Usage ##

Run the program, with optional flags -fg and -bg for foreground and background colours.  A list of available colours are in colours.txt.

`./chip8 -fg=green -bg=black`

Programs can be paused and unpaused by pressing `p`.  While paused the program can be exited by pressing `escape` or a new ROM can be loaded into memory by pressing `r`.