wx_chip8

A CHIP-8 emulator written in Rust.

⚠️ This project is purely educational. The main goal is not to write clean, performant, or idiomatic Rust code, but to learn about emulation and how CHIP-8 works.

---

About

This project was based on the following tutorial:

• A Complete Guide to Writing a CHIP-8 Emulator

And follows the official CHIP-8 specifications:

• CHIP-8 Technical Reference

For testing, I used the following ROM:

• Corax89 CHIP-8 Test ROM

I tried to write most of the code myself, using minimal AI assistance, only to clarify doubts while learning.

---

Features

• Implements all CHIP-8 opcodes
• Supports testing ROMs (like corax89)
• Simple screen rendering (on/off pixels)
• Delay and sound timers
• Basic keyboard input

---

Notes

This project is not perfect:

• It doesn’t focus on optimization, readability, or Rust best practices
• Any bugs or odd behaviors are welcome to be corrected
• Pull requests are encouraged, especially for:
  • Fixing bugs
  • Improving ROM compatibility
  • Suggesting improvements or refactoring

---

Contributing

If you want to contribute:

1. Fork the repository
2. Create a branch for your changes
3. Submit a pull request explaining your changes
4. Feedback and bug fixes are always welcome

---

License

MIT License. Feel free to study, modify, and use this project as a reference.