Skip to content

RetroAssembly

Personal retro game collection cabinet in your browser. RetroAssembly brings classic gaming consoles directly to your browser — NES, SNES, Genesis, GameBoy, Arcade, and more. It auto-detects box art, supports save states with sync, gameplay rewinding, retro-style shaders, and gamepad or on-screen virtual controller input.

Imagearianrhodsandlot/retroassembly:latest
Web UIhttp://your-server:8001
Config path{BASE_DIR}/retroassembly/data
Websiteretroassembly.com
Source codeGitHub

Resource Impact

PerformanceLow — Browser-based emulation, minimal server load
StorageMedium — Stores ROMs, save states, and box art

Installation

sh
mithrandir install retroassembly

Setup

  1. Open your browser and navigate to http://your-server:8001
  2. Create an account after clicking the "Library" button
  3. Upload your ROM files and start gaming

Supported Platforms

RetroAssembly supports numerous retro gaming consoles including:

  • NES / Famicom
  • SNES / Super Famicom
  • Sega Genesis / Mega Drive
  • Game Boy / Game Boy Color / Game Boy Advance
  • Arcade (MAME)
  • And more

Features

  • Auto-detected box art — Your game collection is displayed with beautiful covers
  • Save states — Save and synchronize your game at any point and resume later
  • Rewind — Some emulators allow you to rewind gameplay
  • Spatial navigation — Browse your library with keyboard or gamepad
  • Retro shaders — Enhance your experience with retro-style visual effects
  • Virtual controller — Play on mobile with an on-screen gamepad