arianrhodsandlot/retroassembly

The personal retro game collection cabinet in your browser. Join us on Discord https://discord.gg/gwaKRAYG6t

TypeScript

1,119

1,258 commits

updated Oct 12, 2026

See the code

README

logo

RetroAssembly

GitHub Discord Docker Hub

Join our Discord server

Support me on Ko-fi

RetroAssembly is the personal retro game collection cabinet in your browser.

Features

  • Relive memories from numerous retro gaming consoles in the browser. NES, SNES, Genesis, GameBoy, Arcade... See Supported Platforms below.
  • See your game collection displayed with auto-detected beautiful box arts and covers.
  • Save and synchronize your game at any point and resume later.
  • Made a mistake? Some emulators allow you to rewind gameplay.
  • Browse through platforms and your game library with an intuitive interface with spatial navigation, which means you can just use a keyboard or a gamepad to navigate between games.
  • Enhance your gaming experience with beautiful visual effects with retro-style shaders.
  • Play on the go, even without a physical gamepad, using our on-screen virtual controller.

Screenshots

DesktopMobile
Librarylibrary-desktoplibrary-mobile
Gamesgames-desktopgames-mobile
Platformplatform-desktopplatform-mobile
ROMrom-desktoprom-mobile
Menumenu-desktopmenu-mobile

Getting Started

Choose Your Setup

You have two options to get started with RetroAssembly:

Option 1: Use the Official Hosted Version

Recommended for most users. Perfect if you want to get started quickly without any setup.

  1. Visit retroassembly.com in your web browser.
  2. (Optional) If you're new here, explore the library and try out the available demo games to see how it works.
  3. Login and create your personal game library by uploading your own ROM files.
  4. Once your ROMs are uploaded, select any game from your library to launch it directly in your browser and start playing.
  5. Don't forget to use the in-game menu to save your progress, which will be synchronized for you.

Option 2: Self-Host with Docker

For advanced users who want full control. Perfect if you prefer to host your own instance, have privacy concerns, or want to customize the deployment.

See RetroAssembly's homepage on Docker Hub.

Supported Platforms

RetroAssembly aims to support a wide range of vintage gaming systems. Emulation is powered by Nostalgist.js.

Click here to view the full list.
ConsoleAvailable Emulators
Arcadefbneo, mame2003_plus
Atari 2600stella2014
Atari 5200a5200
Atari 7800prosystem
Atari Lynxmednafen_lynx
Channel Ffreechaf
ColecoVisiongearcoleco
Famicom Disk Systemfceumm, nestopia
Game & Watchgw
Game Boymgba, gearboy, gambatte, tgbdual
Game Boy Advancemgba, vba_next
Game Boy Colormgba, gearboy, gambatte, tgbdual
Game Geargenesis_plus_gx, gearsystem
Genesis / Mega Drivegenesis_plus_gx
Magnavox - Odyssey2 / Philips Videopac+o2em
Master Systemgenesis_plus_gx, picodrive, gearsystem
N64mupen64plus_next
Neo Geo Pocketmednafen_ngp
Neo Geo Pocket Colormednafen_ngp
NES / Family Computerfceumm, nestopia, quicknes
PC Engine (TurboGrafx 16)mednafen_pce_fast
Playstation 1pcsx_rearmed
Sega SG-1000gearsystem
Super NES / Super Famicomsnes9x, snes9x2002, snes9x2005, snes9x2010
Virtual Boymednafen_vb
WonderSwanmednafen_wswan
WonderSwan Colormednafen_wswan

Contributing

See Contributing.

Sponsorship

Sponsor this project on Ko-fi (or alternatively on GitHub Sponsors / Buy Me a Coffee) to show your appreciation!

This keeps the project sustainable and ensures continuous improvements and new features.

Open-source Alternatives

We hope you have a fantastic time revisiting your favorite retro games... Even with applications other than RetroAssembly.

License

MIT

atari
atari2600
emulator
gb
gba
gbc
megadrive
nes
nintendo
pwa
retroarch
retroarch-wasm
retroarch-web
retrogaming
sega
snes
virtualboy
webassembly

arianrhodsandlot/retroassembly

The personal retro game collection cabinet in your browser. Join us on Discord https://discord.gg/gwaKRAYG6t

TypeScript

1,119

1,258 commits

updated Oct 12, 2026

See the code

README

logo

RetroAssembly

GitHub Discord Docker Hub

Join our Discord server

Support me on Ko-fi

RetroAssembly is the personal retro game collection cabinet in your browser.

Features

  • Relive memories from numerous retro gaming consoles in the browser. NES, SNES, Genesis, GameBoy, Arcade... See Supported Platforms below.
  • See your game collection displayed with auto-detected beautiful box arts and covers.
  • Save and synchronize your game at any point and resume later.
  • Made a mistake? Some emulators allow you to rewind gameplay.
  • Browse through platforms and your game library with an intuitive interface with spatial navigation, which means you can just use a keyboard or a gamepad to navigate between games.
  • Enhance your gaming experience with beautiful visual effects with retro-style shaders.
  • Play on the go, even without a physical gamepad, using our on-screen virtual controller.

Screenshots

DesktopMobile
Librarylibrary-desktoplibrary-mobile
Gamesgames-desktopgames-mobile
Platformplatform-desktopplatform-mobile
ROMrom-desktoprom-mobile
Menumenu-desktopmenu-mobile

Getting Started

Choose Your Setup

You have two options to get started with RetroAssembly:

Option 1: Use the Official Hosted Version

Recommended for most users. Perfect if you want to get started quickly without any setup.

  1. Visit retroassembly.com in your web browser.
  2. (Optional) If you're new here, explore the library and try out the available demo games to see how it works.
  3. Login and create your personal game library by uploading your own ROM files.
  4. Once your ROMs are uploaded, select any game from your library to launch it directly in your browser and start playing.
  5. Don't forget to use the in-game menu to save your progress, which will be synchronized for you.

Option 2: Self-Host with Docker

For advanced users who want full control. Perfect if you prefer to host your own instance, have privacy concerns, or want to customize the deployment.

See RetroAssembly's homepage on Docker Hub.

Supported Platforms

RetroAssembly aims to support a wide range of vintage gaming systems. Emulation is powered by Nostalgist.js.

Click here to view the full list.
ConsoleAvailable Emulators
Arcadefbneo, mame2003_plus
Atari 2600stella2014
Atari 5200a5200
Atari 7800prosystem
Atari Lynxmednafen_lynx
Channel Ffreechaf
ColecoVisiongearcoleco
Famicom Disk Systemfceumm, nestopia
Game & Watchgw
Game Boymgba, gearboy, gambatte, tgbdual
Game Boy Advancemgba, vba_next
Game Boy Colormgba, gearboy, gambatte, tgbdual
Game Geargenesis_plus_gx, gearsystem
Genesis / Mega Drivegenesis_plus_gx
Magnavox - Odyssey2 / Philips Videopac+o2em
Master Systemgenesis_plus_gx, picodrive, gearsystem
N64mupen64plus_next
Neo Geo Pocketmednafen_ngp
Neo Geo Pocket Colormednafen_ngp
NES / Family Computerfceumm, nestopia, quicknes
PC Engine (TurboGrafx 16)mednafen_pce_fast
Playstation 1pcsx_rearmed
Sega SG-1000gearsystem
Super NES / Super Famicomsnes9x, snes9x2002, snes9x2005, snes9x2010
Virtual Boymednafen_vb
WonderSwanmednafen_wswan
WonderSwan Colormednafen_wswan

Contributing

See Contributing.

Sponsorship

Sponsor this project on Ko-fi (or alternatively on GitHub Sponsors / Buy Me a Coffee) to show your appreciation!

This keeps the project sustainable and ensures continuous improvements and new features.

Open-source Alternatives

We hope you have a fantastic time revisiting your favorite retro games... Even with applications other than RetroAssembly.

License

MIT

atari
atari2600
emulator
gb
gba
gbc
megadrive
nes
nintendo
pwa
retroarch
retroarch-wasm
retroarch-web
retrogaming
sega
snes
virtualboy
webassembly

Significant stargazers

K.B.Dharun Krishna

220 followers · starred Mar 2026

Wael Nasreddine

219 followers · starred Nov 2025

Dave Lane

192 followers · starred Jun 2025

Andrii Doroshenko

86 followers · starred Nov 2025