v3

RetroAssembly v3 Release Notes

RetroAssembly v3 has been released!

This release brings several features and improvements. Here are the key highlights:

• Searching through the library
• Custom BIOSes
• FBNeo is added as the new default arcade emulator
• 10 new platforms: Atari 7800, PC Engine (TurboGrafx-16), Magnavox Odyssey 2, etc.

Dive into the new features

Searching through the library

A search bar is added to quick navigate to the game you are seeking for.

It can also be opened with a keyboard shortcut: Ctrl + K for Windows/Linux, ⌘ + K for macOS.

Custom BIOSes

Some emulators need BIOSes to work properly. Now we can upload the BIOSes through the settings dialog.

FBNeo

FBNeo is added to support a wider range of arcade games, comparing to MAME 2003-Plus. MAME 2003-Plus is still there, but FBNeo now becomes the default emulator for the arcade platform.

New platforms

Following platforms and their corresponding emulators have been added.

• Atari 5200
• Atari 7800
• Atari Lynx
• Channel F
• ColecoVision
• Famicom Disk System
• Game & Watch
• Magnavox Odyssey 2
• PC Engine (TurboGrafx-16)
• Philips Videopac+

They can be enabled with the settings dialog.

Other improvements and bug fixes

View the full changes on GitHub: v2.250830.1233...v3.251018.1334

Upgrading

• For users of the officially hosted instance (retroassembly.com): All these features have been shipped and you don't need to take any action.
• For self-hosted users: See the "Upgrade" section on our Docker Hub.

Anniversary

31 years ago today, 1994-10-18, Sonic & Knuckles (Mega Drive/Genesis) was released.

---

Happy retro gaming!

v2

RetroAssembly v2 Release Notes

RetroAssembly v2 has been released!

This release brings several features and improvements. Here are the key highlights:

• Customizable metadata and images
• Batch delete ROMs
• Toggle confirm and cancel buttons
• Show focus indicators as needed
• Update password (self-hosted users only)

Dive into the new features

Customizable metadata and images

Personalize your ROM library with custom titles, descriptions, and cover images for each game.

Batch delete ROMs

Quickly remove multiple ROMs at once to keep your collection organized.

Toggle confirm and cancel buttons

Choose between different gamepad styles as you prefer.

Show focus indicators as needed

By default, navigation focus indicators are hidden and will be shown only when spatial navigation is activated. It can be tweaked with this option.

Update password (self-hosted users only)

Self-hosted users can now securely change their account password from within the settings dialog.

Other improvements and bug fixes

View the full changes on GitHub: v1.250801.0400...v2.250830.1233

Upgrading

• For users of the officially hosted instance (retroassembly.com): All these features have been shipped and you don't need to take any action.
• For self-hosted users: See the "Upgrade" section on our Docker Hub.

Anniversary

38 years ago today, 1987-08-30, Street Fighter (Arcade) was released.

---

Happy retro gaming!

v1

RetroAssembly v1 Release Notes

I'm excited to announce that RetroAssembly v1 has been released!

Compared to the initial release (let's just call it v0) last month, this release brings several highly requested features and improvements that enhance your retro gaming experience. Here are the key highlights:

• Docker self-hosting
• Dark mode
• Continue with the latest saved state
• Full screen mode
• MD5-based metadata matching

Dive into the new features

Docker self-hosting

Self-hosting has been the most requested feature since RetroAssembly was announced. We've now released an official Docker image for advanced users who want complete control over their gaming environment.

Quick Start:

docker run -d --name retroassembly -p 8000:8000 -v /path/to/your/data:/app/data arianrhodsandlot/retroassembly

Replace /path/to/your/data with your preferred data directory. This will store your game library, save states, and user data locally.

Learn more: RetroAssembly on Docker Hub.

Dark mode

Enjoy a sleek dark theme! Switch between light and dark modes to match your preference and reduce eye strain during those late-night gaming sessions.

Continue with the latest saved state

A "Continue" button to quickly resume from the last position where you exited has been added.

Full screen mode

Enable full screen mode to enjoy your games without any distractions. You can also enter full screen mode manually while running a game.

MD5-based metadata matching

Game identification and metadata retrieval have been enhanced with MD5 hash matching rather than the old file name based matching.

Other improvements and bug fixes

View the full changes on GitHub: v0.250616.0154...v1.250801.0400

What's Next

I'm constantly working to improve RetroAssembly based on your feedback.

Track our progress on our GitHub project and suggest new features in our Discord community or GitHub discussions.

---

Happy retro gaming!