metteo/chip8-lanterna

:video_game: Chip8 Emulator Lanterna CLI written in Java 11

Chip8 Emulgator TE (Terminal Edition) PoC

Chip8 Emulator / Interpreter / Virtual Machine written in Java 11 with Lanterna CLI as front-end

Warning: Proof of Concept

Prerequisites

• Java Dev Kit 11 installed, with env. variables properly configured:

$JAVA_HOME #Linux / Mac

%JAVA_HOME% @REM Windows

Usage

The project is in PoC state so not really usable as a standalone app. To run it follow development section below.

Development

Below instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

chip8-core installed in local maven repository.

Building

Compilation

./mvnw compile

Install to local repository

./mvnw install

Running from outside IDE (see script header for details):

./mvnw exec:exec@run -Drom=<path to ROM>

then after exiting (Esc):

./src/scripts/chip8.sh <path to ROM>

Built With

• Java 11 - SDK
• Maven - Dependency Management
• Chip8 Core - Emulator Core
• Lanterna - CLI

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details

Acknowledgments

• r/EmuDev
• Cowgod's Chip-8 Technical Reference v1.0
• Mastering Chip-8