Sobre o emulador

O Chippy Bits é um emulador de CHIP-8 desenvolvido como um projeto pessoal para aprendizado em programação de baixo nível e emulação. Atualmente, o projeto está disponível apenas para Linux e Windows, devido à forma que foi codificado. Todavia, os passos que se seguem, referem-se à instalação no sistema operacional Linux.

Processo de instalação

1. Clonar o repositório

git clone https://github.com/JeanC4rlo/chippy-bits.git

2. Entrar na pasta do projeto

cd chippy-bits

3. Instalar as dependências

Ubuntu/Debian:

sudo apt update
sudo apt install g++ make libsdl2-dev

Fedora:

sudo dnf install gcc-c++ make SDL2-devel

Arch Linux:

sudo pacman -S gcc make sdl2

macOS (com Homebrew):

brew install gcc make sdl2

4. Compilar o projeto

make

Se tudo deu certo, você vai ver os arquivos sendo compilados e no final volta pro prompt. O executável vai estar na pasta bin/.

5. Executar com uma ROM

./bin/chippy-bits caminho/para/sua/rom.ch8

Exemplo prático:

# Esse repositório já veio com, no mínimo, 6 ROMs de teste, coletadas do repositório https://github.com/Timendus/chip8-test-suite, elas estão na pasta roms/.

# Rodar
./bin/chippy-bits roms/teste.ch8

Pronto!

A janela do emulador vai abrir e o jogo vai começar. Pra sair, é só fechar a janela ou apertar Ctrl+C no terminal.

Se der erro de SDL, verifica se instalou a biblioteca certa. Se der "ROM not found", confere se o caminho do arquivo tá certo.