arianrhodsandlot/retroassembly — Gitpedia

<img src="public/assets/logo/logo-512x512.png" alt="logo" width="100" height="100"> <h1 align="center">RetroAssembly</h1> <a href="https://github.com/arianrhodsandlot/retroassembly"><img src="https://img.shields.io/github/stars/arianrhodsandlot/retroassembly" alt="GitHub"></a> <a href="https://discord.gg/gwaKRAYG6t"><img src="https://img.shields.io/discord/1129062038543548496?logo=discord" alt="Discord"></a> <a href="https://hub.docker.com/r/arianrhodsandlot/retroassembly"><img src="https://img.shields.io/docker/pulls/arianrhodsandlot/retroassembly" alt="Docker Hub"></a> <a href="https://discord.gg/gwaKRAYG6t"> <picture width="320"> <source media="(prefers-color-scheme: light)" srcset="https://invidget.switchblade.xyz/gwaKRAYG6t?theme=light"> <source media="(prefers-color-scheme: dark)" srcset="https://invidget.switchblade.xyz/gwaKRAYG6t"> <img width="320" alt="Join our Discord server" src="https://invidget.switchblade.xyz/gwaKRAYG6t?theme=light"> </picture> </a> <a href="https://ko-fi.com/arianrhodsandlot"> <img width="320" src="https://cdn.prod.website-files.com/5c14e387dab576fe667689cf/670f5a0171bfb928b21a7e00_support_me_on_kofi_beige.png" alt="Support me on Ko-fi"> </a>

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

	Desktop	Mobile
Library	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/desktop/library.jpg" alt="library-desktop" width="240" height="135">	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/mobile/library.jpg" alt="library-mobile" width="62" height="135">
Games	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/desktop/games.jpg" alt="games-desktop" width="240" height="135">	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/mobile/games.jpg" alt="games-mobile" width="62" height="135">
Platform	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/desktop/platform.jpg" alt="platform-desktop" width="240" height="135">	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/mobile/platform.jpg" alt="platform-mobile" width="62" height="135">
ROM	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/desktop/rom.jpg" alt="rom-desktop" width="240" height="135">	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/mobile/rom.jpg" alt="rom-mobile" width="62" height="135">
Menu	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/desktop/menu.jpg" alt="menu-desktop" width="240" height="135">	<img src="https://cdn.jsdelivr.net/gh/arianrhodsandlot/retroassembly-assets@657978eba57dd4920d57436feaa5dbb7a775e5eb/screenshots/mobile/menu.jpg" alt="menu-mobile" width="62" height="135">

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.

Visit retroassembly.com in your web browser.
(Optional) If you're new here, explore the library and try out the available demo games to see how it works.
Login and create your personal game library by uploading your own ROM files.
Once your ROMs are uploaded, select any game from your library to launch it directly in your browser and start playing.
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.

<details> <summary>Click here to view the full list.</summary>

Console	Available Emulators
Arcade	`fbneo`, `mame2003_plus`
Atari 2600	`stella2014`
Atari 5200	`a5200`
Atari 7800	`prosystem`
Atari Lynx	`mednafen_lynx`
Channel F	`freechaf`
ColecoVision	`gearcoleco`
Famicom Disk System	`fceumm`, `nestopia`
Game & Watch	`gw`
Game Boy	`mgba`, `gearboy`, `gambatte`, `tgbdual`
Game Boy Advance	`mgba`, `vba_next`
Game Boy Color	`mgba`, `gearboy`, `gambatte`, `tgbdual`
Game Gear	`genesis_plus_gx`, `gearsystem`
Genesis / Megadrive	`genesis_plus_gx`
Magnavox - Odyssey2 / Philips Videopac+	`o2em`
Master System	`genesis_plus_gx`, `picodrive`, `gearsystem`
Neo Geo Pocket	`mednafen_ngp`
Neo Geo Pocket Color	`mednafen_ngp`
NES / Family Computer	`fceumm`, `nestopia`, `quicknes`
PC Engine (TurboGrafx 16)	`mednafen_pce_fast`
Sega SG-1000	`gearsystem`
Super NES / Super Famicom	`snes9x`, `snes9x2002`, `snes9x2005`, `snes9x2010`
Virtual Boy	`mednafen_vb`
WonderSwan	`mednafen_wswan`
WonderSwan Color	`mednafen_wswan`