Pecten
A Game Boy Advance emulator that runs in the browser. The emulator core is written in Rust and compiled to WebAssembly; the app shell is React and installs as a PWA for offline, fullscreen play on phones and computers.
Playing games
Start with the User Manual:
- Getting Started: loading ROMs, the library, installing the app
- Saved Games: automatic saves, save states, importing and exporting
.savfiles - Settings: game speed, shaders, sound, touch controls, haptics, themes
- Desktop and Mobile Play: keyboard play, portrait and landscape touch layouts
- Controls and Shortcuts: key bindings and shortcuts
Current status
- ARMv4T ARM/Thumb CPU passing the jsmolka/gba-tests ARM, Thumb, and memory suites
- High-level-emulated BIOS with the common
SWIservices; no BIOS image is needed - Scanline renderer for all display modes, with objects, windows, and blending
- PSG and DirectSound audio at 32,768 Hz
- SRAM, Flash, and EEPROM saves; save states;
.savimport and export - Keyboard and multi-touch input, with haptic feedback on phones
Wait states, the prefetch buffer, serial/link hardware, and several BIOS services are not implemented. Passing the test suites does not mean every game boots. The backlog is tracked in TASKS.md at the repository root.
Documentation layout
- User Manual: how to play, for everyone
- Development: project goals and the build and test workflow
- Architecture: how the emulator core, browser shell, and WebAssembly boundary fit together
- Rust Core: each emulator subsystem in detail: memory map, CPU, BIOS, GPU, audio, and testing
Quick links
- Development Workflow: build and test commands
- Architecture Overview
- WASM Boundary: the exported API, frame loop, and save storage
