Home

Oxide Wiki

Welcome to the official Oxide wiki.

Oxide is a modern CHIP-8 emulator written in Rust with an egui / eframe desktop interface. The project combines a complete CHIP-8 core with a polished UI, multilingual support, save states, debug tooling, and a custom visual identity.

This wiki is organized by chapters so it can be used both as user documentation and as a project reference.

Chapters

Part I - Using Oxide

• 1. Getting Started
• 2. User Interface
• 3. Themes
• 4. Controls and Shortcuts
• 5. Save States
• 6. Debug Terminal
• 7. Settings

Part II - System Overview

• 8. Localization
• 9. Architecture

Part III - Development

• 10. Development Guide
• 11. Troubleshooting

What Oxide currently provides

• Full CHIP-8 CPU implementation
• Configurable compatibility quirks
• Animated startup splash screen
• Three themes: Kiwano, Dark, Light
• 12 UI languages
• Save/load states with per-ROM slots
• Debug terminal with logs, search, export, and test reports
• Keyboard, mouse, and gamepad support
• Audio buzzer with volume control
• Detached Settings and Debug Terminal windows
• Windows single-instance protection

Related documentation in the repository

If you need lower-level technical references, the repository also contains:

• docs/ARCHITECTURE.md
• docs/CPU_EMULATION.md
• docs/SAVE_STATES.md
• docs/UI_SETTINGS.md
• docs/DEVELOPMENT.md
• docs/DEBUG_LOGGING.md