RA2Snes is a program built using Qt 6.9 in C++ and C that bridges the QUsb2Snes webserver & rcheevos client to allow unlocking Achievements on real Super Nintendo Hardware through the SD2Snes USB port.

Download the latest firmware for your SD2Snes.

Download the latest version of QUsb2Snes.

Plug the SD2Snes into your computer (Linux users may need to allow Serial Port communications to enable communication between QUsb2Snes and SD2Snes).

Run both QUsb2Snes and RA2Snes.

Once RA2Snes has been run for the first time, the settings.ini file is created in the same directory as RA2Snes. This file holds all program settings, including your saved login information.

SD2Snes cannot currently read the memory of Super Game Boy and games with certain enhancement chips.

The SD2Snes firmware may have crashed. Power cycling the SNES should fix the issue. Ensuring a good USB connection and booting QUsb2Snes and RA2Snes before powering on the SNES will mitigate any crashes.

Some achievements may activate without the requirement being met. All known instances occur on both emulator and hardware.

When this happens, click on the achievement title to go to its page on the RetroAchievements Website and reset that achievement! Then click on the Refresh RetroAchievements Data Button to reflect the changes.

Achievements might have a tight frame window. This may cause achievements not to activate because reading the memory of SD2Snes is not frame-perfect.

I recommend unlocking more achievements before retrying an achievement, as the fewer achievements there are, the fewer memory values need to be read from SD2Snes.

If an achievement does not trigger at all, please see my RetroAchievements profile for the SNES games I have completed (all SNES games supported will be completed on RA2Snes).

If an achievement does not trigger and is not completed on my profile, you can send proof of meeting the requirements for an achievement in the Manual Unlocks thread in the RetroAchievements Discord and put in an issue so I can look into it.

See FUTURE.md

See COMPILING.md

• Skarsnik for QUsb2Snes, usb2snes client, and helping with various implementations used in RA2Snes
• rcheevos and its contributors
• Many users in the RetroAchievements Discord's coding channel for helping answer any questions I had.
• miniz and its contributors (License and information can be found on the miniz GitHub or in the miniz folder in this repo)

• RetroAchievements Logo
• RetroAchievements SVG Icons
• Wikipedia's Famicom SVG
• Famicom Logo by Nintendo

• NES RA Adapter - Repository for everything related with the RetroAchievements adapter for the real NES hardware
• TCheeve - A client for RetroAchievement using the Emulator Network Access protocol

RA2Snes is available under the GPL V3 license. Full text here: http://www.gnu.org/licenses/gpl-3.0.en.html

Copyright (C) 2024 Factor (Factor64)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.