HFO4/gameboy.live
Gameboy.live
This project is a GameBoy hardware emulator that simulates the original processor, graphics, and sound systems to run vintage ROMs. It provides a core emulation engine that executes instructions using cycle-accurate simulation to match original hardware timing.
The emulator is designed for remote play, enabling cloud game streaming via HTTP and WebSockets. This allows for remote cooperative gaming through a web browser and terminal-based gaming where game state is rendered via telnet.
The system includes capabilities for memory-mapped I/O emulation and state-based save restoration to preserve game progress. It also provides diagnostic tools for emulator state debugging, allowing users to set breakpoints and inspect memory or register states during runtime.
Features
- Game Console Simulation - Runs vintage GameBoy ROMs by simulating the original processor, graphics, and sound hardware on modern devices.
- GameBoy - Executes game ROMs by simulating the processor, timers, interrupts, sound, and graphics hardware.
- Cloud Game Streaming - Enables playing games over a network by receiving visual updates and sending inputs via HTTP or WebSockets.
- Memory-Mapped I/O Simulation - Simulates the mapping of hardware registers and RAM to host memory addresses to control graphics and sound.
- Cycle-Accurate Emulators - Implements precise clock cycle tracking to ensure original hardware timing and behavior are accurately simulated.
- Emulator Save States - Captures the entire system memory and register state into a binary file to resume gameplay.
- Game State Debug Toggles - Provides tools to set breakpoints and inspect memory or register states to analyze game execution during runtime.
- Telnet-Based Game Streaming - Provides a way to play games within a terminal environment by rendering game state via telnet.
- Terminal Games - Allows playing retro games directly inside a terminal emulator using telnet.
- Remote Frame Streaming - Converts emulator video memory into images and serves them over HTTP for remote browser viewing.
- Game Streaming Hosts - Serves game screenshots and accepts user inputs over HTTP and WebSockets for remote browser-based playback.
- Remote Cooperative Play - Shares a live game session through a web browser to allow multiple people to play together remotely.
- Telnet-Based Rendering - Sends game state updates as text characters or ANSI escape codes to a terminal emulator via telnet.
- Web-Based Input Relays - Transmits user input events from a remote client to the emulator core via a persistent WebSocket connection.
- Emulator State Inspection - Provides a debugging interface to inspect internal emulator components such as CPU registers and memory dumps.
