v7

RetroAssembly v7 has been released!

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

• Initial support for Nintendo 64
• Customizable gamepad hotkeys
• Enhanced virtual gamepad
• Enhanced game media viewing
• Share your library with other users (self-hosted only)

Dive into the new features

Initial support for Nintendo 64

RetroAssembly now supports Nintendo 64 games by integrating the Mupen64Plus-Next core!

Limitations:

• It may crash at any time (like while launching, playing or saving) so do not rely on it too much.
• Analog key mapping is not yet supported. A controller is required to play most of the games.

Enhanced virtual gamepad

The virtual gamepad has been improved for mobile and touch-screen users. We now make it work more like a physical gamepad, you can move your finger from one button to another without lifting your finger. Besides that, dedicated rewind and fast-forward buttons are now available.

Customizable gamepad hotkeys

Gamepad hotkeys for common actions can now be customized to your preference. You can select the button combinations for pause, rewind, and fast-forward.

Enhanced game media viewing

Game media has been completely overhauled with a new carousel interface, making it easier than ever to browse screenshots, box art, and other media for your games.

You can now upload any kind of file as game media, and we automatically detect the file type and display the appropriate preview. We now support images(jpg, png, etc), videos(mp4, mov, etc), and documents(pdf and cbz).

Share your library with other users (self-hosted only)

For self-hosted instances with multiple users, we now allow you to share your library with other users, so it's nolonger needed to upload ROMs individually for each user.

Other improvements and bug fixes

View the full changes on GitHub: v6.260524.1410...v7.260719.1051

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

35 years ago today, 1991-07-19, Final Fantasy IV (titled Final Fantasy II in its initial North American release) (Super Famicom/Super Nintendo Entertainment) was released.

---

Happy retro gaming!

v6

RetroAssembly v6 has been released!

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

• Initial support for PlayStation
• Add game to favorites
• Load external RetroArch states
• Accessibility improvements for users with color sensitivities

Dive into the new features

Initial support for PlayStation

RetroAssembly now supports PlayStation games by integrating PCSX ReARMed!

Limitations:

• Only CHD format is supported.
• Disk swapping is not supported yet.

Add game to favorites

Easily access your favorite games by adding them to the favorites list. Simply click the heart icon, and access them quickly both from the home page and the dedicated favorites page later.

You can also filter your favorites by platform.

Load external RetroArch states

If you have exsisting save states from the same emulator in RetroArch, you can now load them in RetroAssembly. Launch the game, open the menu and click the "Load an external state" button, then you can import it from your disk.

Accessibility improvements for users with color sensitivities

We now support tweaking the saturation of the UI to make it more comfortable for users with color sensitivities. You can find this option in the general settings under "Accessibility".

Other improvements and bug fixes

View the full changes on GitHub: v5.260124.0752...v6.260321.1810

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

30 years ago today, 1996-03-22, Resident Evil (PlayStation) was released.

---

Happy retro gaming!

v5

RetroAssembly v5 has been released!

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

• Auto-saving functionality
• Platform-specific shader settings
• 29 new shaders
• Launch recently played games from the search bar
• Multi-user support for self-hosted users
• Perfermance improvements for loading games' metadata

Dive into the new features

Auto-saving functionality

Never lose your progress! Auto-saving automatically saves your game at intervals, ensuring you can always pick up where you left off. It's disabled by default and can be enabled in the settings.

Platform-specific shader settings

Configure different shaders per platform for the optimal visual experience, allowing you to customize the look and feel of each console separately.

New visual shaders

Added 29 new additional shaders to enhance your retro gaming experience with beautiful visual effects.

Launch recently played games from the search bar

The search bar now includes recent games as default suggestions, making it easier to quickly launch the titles you play most often.

Multi-user support for self-hosted users

RetroAssembly now supports multiple users on a single instance for self-hosted users! Create separate profiles for family members or friends, each with their own game libraries, saves, and preferences.

Perfermance improvements for loading games' metadata

In the past, we only stored metadata identifiers in the database, which meant that loading game metadata required additional API calls. This is reasonable for the officially hosted instance, since latency between the metadata server and the main server is low. But for self-hosted users, it could lead to significant delays, especially with large libraries.

Now, we store the full metadata in the database after ROMs are added, significantly speeding up the loading process. This change will be applied automatically when you upgrade to v5. Note that the initial migration may take some time depending on the size of your library.

Other improvements and bug fixes

View the full changes on GitHub: v4.251127.0822...v5.260117.0500

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

25 years ago today, 2001-01-17, Progear (Arcade) was released.

---

Happy retro gaming!

v4

RetroAssembly v4 Release Notes

RetroAssembly v4 has been released!

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

• Redesigned library home page
• Internationalization (i18n) support
• Sortable game lists
• Upgraded emulators

Dive into the new features

Redesigned library home page

In the past, the library home page displayed a full list of games, which could be overwhelming for large libraries. Now, the home page shows the most recently saved/played/added games, making it easier to discover and access your favorite titles.

Internationalization (i18n) support

Bonjour! Hola! RetroAssembly now supports multiple languages, allowing users to switch between different languages for a more personalized experience.

Sortable game lists

You can now sort your game lists by various criteria such as name, date released, and date added, making it easier to organize and find games in your library.

Upgraded emulators

The bundled RetroArch has been upgraded to v1.22.2, bringing the latest improvements from the upstream projects.

The RetroArch files are also compressed with zip to reduce their size, which should significantly improve loading times, especially for large emulators like FBNeo (decreased from ~34MB to ~10MB).

Other improvements and bug fixes

View the full changes on GitHub: v3.251018.1334...v4.251121.1346

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

33 years ago today, 1991-11-21, The Legend of Zelda - A Link to the Past (Super Famicom/Super Nintendo Entertainment System) was released.

---

Happy retro gaming!

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!