https://github.com/danielcoderx/chise
chip 8 SDL-based Emulator
https://github.com/danielcoderx/chise
c chip-8 chip8 chip8-emulator emulation emulator sdl
Last synced: 17 days ago
JSON representation
chip 8 SDL-based Emulator
- Host: GitHub
- URL: https://github.com/danielcoderx/chise
- Owner: DanielcoderX
- License: mit
- Created: 2021-12-11T12:36:54.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-07-23T19:14:08.000Z (over 2 years ago)
- Last Synced: 2025-04-08T00:34:13.443Z (12 months ago)
- Topics: c, chip-8, chip8, chip8-emulator, emulation, emulator, sdl
- Language: C
- Homepage:
- Size: 44.9 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# chise - Chip 8 SDL-based Emulator
## Introduction
**chise** is a fascinating emulator that brings the nostalgic charm of the Chip 8 system to life. Powered by SDL (Simple DirectMedia Layer), it provides a smooth and enjoyable experience, running classic Chip 8 ROM games with ease.
## Installation
### Arch Linux based
```bash
pacman -S sdl_gfx sdl_mixer sdl_sound sdl_image sdl_net sdl_ttf sdl12-compat
```
### Ubuntu and Debian based
```bash
apt-get install build-essential libsdl1.2-dev
```
### Compiling
To embark on your journey into the world of Chip 8, simply run the following command:
```bash
make
```
## Usage
:warning: **Warning:** Only .rom or .ch8 files are supported.
:bulb: **Tip:** Press `Esc` to exit, `R` to reload, and `P` to pause.
If you pause using `P`, you can use `Esc` to exit and `U` to resume.
To begin your adventure, load a Chip 8 ROM file using the following command:
```bash
build/emu or build/emu
```
For example:
```bash
build/emu ch8/random_number_test.ch8
```
## Contributing
Embark on this exciting journey by contributing to chise! Your pull requests are warmly welcomed. If you plan to make significant changes, please open an issue first to discuss your ideas.
Please make sure to update tests as appropriate.
## License
This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/). Feel free to use and modify it, following the terms of the license. Let's keep the spirit of retro gaming alive! đšī¸