Skip to content
/ retrobob Public

retrobob is a retro gaming emulator that runs directly on your browser. Super Nintendo, NES/Famicom, Gameboy and Gameboy Color are currently supported, with more systems to come.

License

Notifications You must be signed in to change notification settings

iury/retrobob

Repository files navigation

Overview

retrobob is a retro gaming emulator made by iury that runs directly on your browser.

Super Nintendo, NES/Famicom, Gameboy and Gameboy Color are currently supported, with more systems to come.

You can also download it as a native executable for stable FPS and better audio quality.

Don't have a ROM to test it? Try Super Tilt Bro, a free game made by sgadrat.

Links

Live demo

Warning

You'll most likely lose your savestates after version releases. So, if you are playing for real then I recommend downloading the executable and saving locally. As we're under active development, no compatibility is guaranteed between different versions.

Compiling

You'll need pnpm, zig 0.12, and emscripten installed, active and with the cache generated (compile a hello world using emcc). Then, it is as simple as:

git submodule update --init --recursive
pnpm install
cd packages/ui
pnpm dev

You can also run the emulator directly as a native executable, without the browser:

cd packages/engine
zig build run --release=fast

Controls

A gamepad (Xbox/PS) or keyboard:

System Action Key
Global
Fullscreen F11
Save state F1
Load state F4
Reset F3
Pause / resume Space
D-pad Arrow keys
Select Q
Start W or Enter
Super Nintendo
Y A
X S
B Z
A X
L D
R C
NES / Famicom / GB / GBC
B Z or A
A X or S
Gameboy (monochrome)
Toggle color palettes T

Supported Systems

SNES

  • Most commercial games are playable if they don't require a coprocessor.
  • All background modes are implemented, including Mode 7 (+ExtBG).
  • NTSC/PAL, 224p/239p + interlacing, pseudo hires (SETINI) and true hires (mode 5/6) are supported.
  • Offset per tile (on mode 2, 4 and 6) is implemented.
  • All PPU features, including mosaic, color windows and color math are implemented.

Known Issues

  • You may experience random glitches and crashes due to emulation inaccuracies.
  • A few games are unplayable, notably all Donkey Kong Country games and various Square and Enix JRPGs.

GB / GBC

  • Most commercial games should work.
  • MBCs implemented: ROM, MBC1, MBC2, MBC3 (+RTC) and MBC5.
  • Games in monochrome will use a color palette like playing on a GBC hardware by default but you can toggle it by pressing T.

Known Issues

  • Super Mario Bros. Deluxe (slowdowns and glitches)

NES / Famicom

  • Most commercial games should work.
  • Mappers implemented: NROM, CNROM, UxROM, AxROM, MMC1, MMC2 and MMC3.

Known Issues

  • Castlevania 3 (MMC5 mapper is not implemented)
  • Batman: Return of the Joker (FME-7 mapper is not implemented)
  • Battletoads and BT&DD (random crashes)

About

retrobob is a retro gaming emulator that runs directly on your browser. Super Nintendo, NES/Famicom, Gameboy and Gameboy Color are currently supported, with more systems to come.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages