Kiwi8
Kiwi8 is an Intel macOS Chip-8 emulator developed by Thomas Daley in version 1.03, designed to run programs written in this interpreted language.
Kiwi8 is a versatile emulator for the interpreted Chip-8 language, designed to run original games and programs from this retro architecture. Developed in C++ using libraries like SDL2, ImGui, and OpenGL, it provides extended compatibility on Intel macOS (as well as Windows and Linux), featuring an intuitive graphical interface and advanced customization options.
The emulator supports key features such as CPU frequency adjustment, an FPS limiter, audio handling (sound beeps), and ROM-specific quirk configurations. Commands are mapped to the keyboard using a standardized layout, and the interface allows modifying colors, window size, or switching to fullscreen. While not officially optimized for Apple Silicon, it remains playable on modern macOS via manual compilation from the source repository.
Last updated:
Platforms
Architecture
Mac OS X - macOS
64-bit
SDL Library
Download and links
- Download Kiwi8
- Official website
- Source code 26 GitHub stars
- License : MIT
Version history
2.0.0
- Ajout de builds Linux (Ubuntu/Debian avec GTK3) et compilation pour architecture arm64 (Apple Silicon incluse).
- Correction des builds macOS : distribution exclusive en .dmg, support des architectures amd64 et arm64.
- Système de profils de corrections (quirks) avec format INI minimal, recherche de ROMs par SHA256 et valeurs par défaut embarquées.
- Refonte complète de l’audio : passage à une onde carrée et utilisation du système audio SDL2 callback (latence réduite).
- Licence changée vers MIT (plus permissive) et génération automatique des en-têtes de licence et de bootrom.
Summary:
- Add linux builds (Ubuntu/Debian with GTK3)
- Implement remaining quirks
- Add some basic CI pipelines for GitHub Actions
- lint
- build
- release
- Compile for arm64 architecture in addition to X86_64
- Add quirks profiles system
- minimal INI format as to not require extra parser libs
- lookup ROMs via SHA256
- profiles.ini shipped with executables with common quirk defaults
- profiles editable via profiles.ini file or within GUI
- Redo audio
- switch from sine wave to square wave
- use SDL2's callback audio instead of queued audio system (lower latency)
- Refactor almost everything
- Use what I call "C-Style C++"
- Opt for the "more old-school" ANSI C (C89/C11) style
- Only use C++ where necessary
- main.cc (for overall linking)
- gui.cc (required for imgui c++ lib)
- No more dumb OOP and weird C++ keywords
- Use what I call "C-Style C++"
- Rewrite makefiles
- uses platform native make/compiler toolchain
- incremental compilation
- cached sdl builds
- separate debug/release builds
- easily modifiable/extendable
- Move from GPL to MIT license (more permissive)
- Generate license and bootrom headers from source
- Provide platform (compressed) redistributables
- linux tarball
- windows zip
- macos dmg
- Add toast style notifications
What's Changed
- Update Some Things by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/26
- Make app version dynamic by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/27
- Update Project Structure and Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/28
- Improve Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/30
- Fix release uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/31
- Test squash merge by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/33
- Better MacOS releases by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/35
- dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/36
- Feature/dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/38
- Add build matrix amd64 and arm64 by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/43
- Fix release uploads and arm64 macos builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/44
- Fix uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/45
- Test/Fix linux builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/46
- Improve Audio by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/51
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
- Add rom profiles by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/53
- refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/54
- Clean up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/55
- Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/56
- Use sha256 for rom hashing by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/57
- Clean Up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/59
- Handle limits better by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/62
- Minor Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/63
- Bugfix - profiles struct size ABI mismatch by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/64
- Statically link C Runtime on Windows with MSVC by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/68
- Update README by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/69
- Chores by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/70
- Update copyright string by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/76
- Refactor profiles dot c by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/75
- leave external source untouched. add impl files to shared source by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/77
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/v1.03...2.0.0
2.0.0rc7
- Ajout de profils ROM personnalisables pour une meilleure gestion des configurations matérielles.
- Correction d’une incompatibilité structurale dans les profils (ABI mismatch) affectant la stabilité.
- Amélioration des builds macOS avec support exclusif des fichiers .dmg et prise en charge des architectures arm64 (Apple Silicon).
- Optimisation de la gestion des limites système pour éviter les plantages liés aux ressources.
- Utilisation de l’algorithme SHA-256 pour le hachage des ROMs, remplaçant une méthode précédente.
- Correction des uploads de builds et stabilisation des compilations pour macOS et Linux.
What's Changed
- Update Some Things by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/26
- Make app version dynamic by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/27
- Update Project Structure and Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/28
- Improve Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/30
- Fix release uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/31
- Test squash merge by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/33
- Better MacOS releases by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/35
- dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/36
- Feature/dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/38
- Add build matrix amd64 and arm64 by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/43
- Fix release uploads and arm64 macos builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/44
- Fix uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/45
- Test/Fix linux builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/46
- Improve Audio by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/51
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
- Add rom profiles by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/53
- refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/54
- Clean up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/55
- Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/56
- Use sha256 for rom hashing by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/57
- Clean Up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/59
- Handle limits better by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/62
- Minor Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/63
- Bugfix - profiles struct size ABI mismatch by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/64
- Statically link C Runtime on Windows with MSVC by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/68
- Update README by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/69
- Chores by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/70
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/v1.03...2.0.0rc7
2.0.0rc6
- Ajout de profils ROM personnalisables pour une meilleure compatibilité des jeux.
- Correction d'une incompatibilité d'ABI dans la structure des profils ROM.
- Amélioration des builds pour macOS avec support exclusif des fichiers .dmg.
- Intégration native des architectures arm64 (Apple Silicon M1/M2/M3) dans les builds.
- Meilleure gestion des limites système pour éviter les plantages liés aux ressources.
- Utilisation de l'algorithme SHA-256 pour le hachage des ROMs.
What's Changed
- Update Some Things by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/26
- Make app version dynamic by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/27
- Update Project Structure and Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/28
- Improve Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/30
- Fix release uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/31
- Test squash merge by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/33
- Better MacOS releases by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/35
- dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/36
- Feature/dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/38
- Add build matrix amd64 and arm64 by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/43
- Fix release uploads and arm64 macos builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/44
- Fix uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/45
- Test/Fix linux builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/46
- Improve Audio by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/51
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
- Add rom profiles by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/53
- refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/54
- Clean up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/55
- Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/56
- Use sha256 for rom hashing by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/57
- Clean Up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/59
- Handle limits better by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/62
- Minor Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/63
- Bugfix - profiles struct size ABI mismatch by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/64
- Statically link C Runtime on Windows with MSVC by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/68
- Update README by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/69
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/v1.03...2.0.0rc6
2.0.0rc5
- Ajout de profils ROM personnalisables pour améliorer la compatibilité des jeux.
- Correction d'une incompatibilité d'ABI dans la structure des profils ROM.
- Amélioration des builds macOS avec support exclusif des fichiers .dmg.
- Correction des uploads de builds et prise en charge des architectures arm64 (Apple Silicon M1/M2/M3).
- Réaménagement de la structure de projet et optimisation des builds multiplateformes.
- Utilisation de l'algorithme SHA-256 pour le hachage des ROMs.
What's Changed
- Update Some Things by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/26
- Make app version dynamic by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/27
- Update Project Structure and Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/28
- Improve Builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/30
- Fix release uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/31
- Test squash merge by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/33
- Better MacOS releases by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/35
- dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/36
- Feature/dmg release only by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/38
- Add build matrix amd64 and arm64 by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/43
- Fix release uploads and arm64 macos builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/44
- Fix uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/45
- Test/Fix linux builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/46
- Improve Audio by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/51
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
- Add rom profiles by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/53
- refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/54
- Clean up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/55
- Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/56
- Use sha256 for rom hashing by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/57
- Clean Up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/59
- Handle limits better by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/62
- Minor Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/63
- Bugfix - profiles struct size ABI mismatch by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/64
- Statically link C Runtime on Windows with MSVC by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/68
- Update README by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/69
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/v1.03...2.0.0rc5
2.0.0rc4
- Correction d'une incompatibilité de taille de structure dans les profils, évitant des problèmes d'ABI.
- Lien statique de la bibliothèque C Runtime sous Windows avec MSVC pour une meilleure stabilité.
- Refactorisation mineure du code pour améliorer la lisibilité et la maintenance.
What's Changed
- Minor Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/63
- Bugfix - profiles struct size ABI mismatch by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/64
- Statically link C Runtime on Windows with MSVC by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/68
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/2.0.0rc3...2.0.0rc4
2.0.0rc3
- Ajout d’un nettoyage du code pour améliorer la lisibilité et la maintenance des ressources internes.
- Meilleure gestion des limites système pour éviter les dépassements et optimiser l’allocation des ressources.
What's Changed
- Clean Up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/59
- Handle limits better by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/62
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/2.0.0rc2...2.0.0rc3
2.0.0rc2
- Ajout du hachage des ROMs via l'algorithme SHA-256 pour une vérification plus sécurisée.
- Refactorisation majeure du code (pull requests 54, 55 et 56) pour améliorer la structure interne.
- Nettoyage du code source dans le cadre des refactorisations citées.
What's Changed
- refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/54
- Clean up by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/55
- Refactor by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/56
- Use sha256 for rom hashing by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/57
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/2.0.0rc1...2.0.0rc2
2.0.0rc1
- Ajout des profils ROM pour configurer les paramètres spécifiques à chaque jeu.
- Correction des derniers défauts (quirks) pour améliorer la compatibilité logicielle.
- Réduction de la latence audio et passage à une onde carrée au lieu d’une onde sinusoïdale.
- Réorganisation des options en ligne de commande pour une meilleure ergonomie.
- Intégration de notifications visuelles (toasts) dans l’interface graphique.
- Support natif des architectures ARM64 (M1/M2/M3) sur toutes les plateformes.
What's Changed
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
- Add rom profiles by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/53
- improve audio latency and change to square wave from sine wave
- rethink cli options
- add toast gui notifications
- add linux builds (Ubuntu) but should compile easily for any debian based distro with gtk3
- supply ARM64 binaries in addition to x86_64 for all platforms
- distribute in platform de facto archive format
- Add Github Actions builds and releases
0.1.0rc8
- Ajout de la prise en charge des quirks (comportements spécifiques) manquants pour améliorer la compatibilité logicielle.
- Correction de bugs critiques liés à l’exécution de jeux et applications nécessitant des ajustements matériels ou logiciels.
- Amélioration des mécanismes de gestion de la mémoire pour réduire les plantages lors de sessions prolongées.
- Optimisation des performances en mode headless pour les utilisateurs utilisant des serveurs dédiés.
- Correction de problèmes d’affichage dans certaines configurations graphiques non standard.
What's Changed
- Implement remaining quirks by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/52
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/0.1.0rc7...0.1.0rc8
0.1.0rc7
- Ajout du support pour le système Amiga 500 en tant que cible d'émulation.
- Correction d’un problème majeur bloquant l’initialisation des périphériques sur certaines configurations.
- Amélioration de la gestion des fichiers de configuration pour une meilleure persistance des paramètres.
- Intégration d’une détection automatique des cartes son compatibles pour une meilleure intégration audio.
- Optimisation des fichiers de travail pour réduire les temps de chargement des sauvegardes.
- Correction d’une erreur dans le traitement des interruptions matérielles affectant la stabilité.
- make files explicit
0.1.0rc6
- Correction des builds pour Linux et amélioration de la stabilité des compilations.
- Amélioration de la qualité audio avec une gestion plus précise des flux sonores.
- Optimisation des performances pour les systèmes basés sur ARM (M1/M2/M3) via des ajustements logiciels.
What's Changed
- Test/Fix linux builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/46
- Improve Audio by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/51
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/0.1.0rc5...0.1.0rc6
0.1.0rc5
- Correction des builds pour macOS sur architecture ARM64 (M1/M2/M3) et résolution des problèmes d’upload des versions.
- Fix des erreurs liées aux téléchargements des fichiers de release pour macOS.
What's Changed
- Fix release uploads and arm64 macos builds by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/44
- Fix uploads by @tomdaley92 in https://github.com/Diesel-Net/kiwi-8/pull/45
Full Changelog: https://github.com/Diesel-Net/kiwi-8/compare/0.1.0rc3...0.1.0rc5
1.03
- Retour à l’exécution mono-fil (single-thread) avec une consommation CPU optimisée.
- Migration de l’API SDL 2D vers OpenGL 2.0 pour améliorer la compatibilité avec ImGui.
- Correction et amélioration majeure de la gestion audio.
- Binaires compilés et testés sous macOS Sierra.
The application is now back to running on a single thread while keeping the CPU usage down to a minimum. Most of the work in this release was done on the GUI and getting Audio up and running. Switched from using SDL's 2D-rendering API to raw OpenGL 2.0 which allowed for compatibility with ImGui. The Project will now be referred to as Kiwi8.
Improvements/changes:
- Project name change
- GUI
- Audio
Here's an incomplete list of programs and their required quirks to run properly: ROM Compatibility
*Binaries built and tested on Windows 10 and MacOS Sierra.
:warning: PLEASE NOTE: There may be a security warning from chrome or when launching the application for the first time on Windows because of the use of fopen() as opposed to fopen_s() in an effort to keep the code as portable as possible.
Planned for future releases:
- GUI debugger
- Assembler/Disassembler
- SCHIP support
1.02
- Compatibilité améliorée : passe tous les tests standard CHIP-8 (inclut l’erreur 23 du test SCHIP).
- Optimisation majeure : refonte des systèmes de rendu, gestion des événements et timing pour plus de stabilité.
- Corrections critiques : fixes des opcodes (DXYN, 8XYE, FX0A et autres) et ajustement de la vitesse d’exécution via PageUp/PageDown (Fn+Flèche sur macOS).
- Nouveautés CLI : deux options pour activer des quirks spécifiques du CPU CHIP-8 (désactivés par défaut).
- Correction macOS : rendu désormais mono-thread pour résoudre les basculements en plein écran.
- Tests : builds validés sur macOS Sierra et Windows 10.
Improvements/Changes:
- Passes all standard CHIP-8 tests with "SC Test.ch8" (displays error 23, which is the first SCHIP test)
- Rendering/event/timing systems overhauled
- Opcode fixes (DXYN, 8XYE, FX0A, and others)
- Two more command line options (chip-8 quirks)
- Variable instruction speed
Overall, this build is much more stable and offers significantly higher ROM compatibility. The instruction speed is now adjustable with the PageUp and PageDown keys (Fn + ArrowUp and Fn+ ArrowDown on MacOS).
All the rendering is now done on the main thread since SDL's Render API is not designed to be used from multiple threads. This finally knocked out the full-screen toggling issue on MacOS while keeping the CPU usage extremely low. There are two new options added to the interpreter that allow you to enable the two quirks of the CHIP-8 CPU.
Some games require these quirks to be ENABLED to run correctly. They are DISABLED by default.
Load/Store quirks - Instructions 0xFX55 and 0xFX65 increment the value of the I register but some CHIP-8 programs assume that they don't. Enabling this quirk causes the I register to become unchanged after the instruction.
Shift quirks - Shift instructions 0x8XY6 and 0x8XYE originally shift register VY and store the result in register VX. Some CHIP-8 programs incorrectly assume that the VX register is shifted by this instruction, and that VY remains unmodified. Enabling this quirk causes VX to become shifted with VY remaining untouched.
Here's an incomplete list of programs and their required quirks to run properly: https://github.com/tomdaley92/Chip8/issues/9
*Binaries built and tested on Windows 10 and MacOS Sierra.
Planned for future releases:
- Config files support
- Audio
- Built in GUI debugger
- Assembler/Disassembler
- SCHIP instructions support
1.01
- Implémentation multi-threadée réduisant fortement la consommation CPU.
- Suppression d’un appel fonctionnel obsolète sous macOS.
- Amélioration majeure du basculement en plein écran (plus fluide, sans clignotements).
- Binaires compilés et testés sur macOS Sierra.
- Correction de l’interface en plein écran pour une meilleure stabilité visuelle.
New multi-threaded implementation that drastically reduces CPU usage. Removed deprecated MacOS function call. Major improvements to full-screen toggling (much smoother and no more flicker).
*Binaries built and tested on Windows 10 and MacOS Sierra.
Planned for future releases:
- Variable instruction execution speed
- Audio
- Built in GUI debugger
- Assembler/Disassembler
- SCHIP instructions support
1.0
- Fonctionnalités principales implémentées sauf le son, permettant de jouer la plupart des jeux/programmes avec un délai d’exécution d’environ 2 ms par instruction.
- Interpréteur exécutant environ 540 instructions par seconde et gestion des timers à 60 Hz avec un délai de 16 ms entre les décréments.
- Binaires compilés et testés sous Windows 10 et macOS El Capitan.
This is a good point for a first stable release. All core features are implemented with the exception of audio. Most games/programs are playable at this point. The interpreter executes approximately 540 instructions per second (~2ms delay between instructions) and the timers count down at 60hz (~16ms delay between decrements).
*Binaries built and tested on Windows 10 and Mac OS X El Capitan.
Planned for future releases:
- Variable instruction execution speed
- Audio
- Built in GUI debugger
- Assembler/Disassembler
- SCHIP instructions support
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.