What is this?
suyu is a Nintendo Switch emulator and AArch64 native recompiler written in C++, preserved at its final public release v0.04.
suyu is a Nintendo Switch emulator and AArch64 native recompiler written in C++, preserved at its final public release v0.04.How does it actually run Switch games?Two ways: HLE emulation mode runs titles through the suyu core (GPU, CPU, audio, services), and recompiler mode statically recompiles a game's AArch64 code ahead of time into native x86-64 executables that use the same HLE backend.
Two ways: HLE emulation mode runs titles through the suyu core (GPU, CPU, audio, services), and recompiler mode statically recompiles a game's AArch64 code ahead of time into native x86-64 executables that use the same HLE backend.How do I get it running?Grab a prebuilt Windows, Linux or Android package from the GitHub releases page. To build from source instead, you need CMake 3.15+, Ninja, Qt 6.4+, the Vulkan SDK, libusb and OpenSSL.
Grab a prebuilt Windows, Linux or Android package from the GitHub releases page. To build from source instead, you need CMake 3.15+, Ninja, Qt 6.4+, the Vulkan SDK, libusb and OpenSSL.Do I need my own games to use it?Yes — it runs decrypted Switch titles only, and you must supply both the games and their encryption keys yourself; the emulator ships neither, which is also the core of its legal notice.
Yes — it runs decrypted Switch titles only, and you must supply both the games and their encryption keys yourself; the emulator ships neither, which is also the core of its legal notice.Is suyu still being developed?No. v0.04 is the final public release and the repository is a public archive — no further development or downloads are planned; the code is kept under GPL-3.0 for historical reference and community use.
No. v0.04 is the final public release and the repository is a public archive — no further development or downloads are planned; the code is kept under GPL-3.0 for historical reference and community use.Which platforms can it run on?Windows, Linux and Android — automated builds for all three are published to the releases page. macOS and iOS are not covered by this release.
Windows, Linux and Android — automated builds for all three are published to the releases page. macOS and iOS are not covered by this release.How does it render Switch games' graphics?In HLE mode the Switch's GPU is emulated by the suyu core alongside CPU, audio and services, and builds depend on the Vulkan SDK, so rendering goes through Vulkan.
In HLE mode the Switch's GPU is emulated by the suyu core alongside CPU, audio and services, and builds depend on the Vulkan SDK, so rendering goes through Vulkan.What community fixes ended up in this final build?Users reported that installed updates/DLC, service handler registration and RomFS registration were broken in the archived build. Fixes for those were folded in as bug fixes to suyu itself, but the release remains the same final v0.04 — it is not new development.
Users reported that installed updates/DLC, service handler registration and RomFS registration were broken in the archived build. Fixes for those were folded in as bug fixes to suyu itself, but the release remains the same final v0.04 — it is not new development.Is suyu related to Eden or other Switch emulators?It is based on Eden, with suyu's own improvements to the UI, the recompiler and platform support.
It is based on Eden, with suyu's own improvements to the UI, the recompiler and platform support.Why does the README talk so much about the DMCA?It argues suyu does not circumvent Nintendo's technological protection measures: users supply their own games and keys, decryption relies on the public AES standard, and the project claims the DMCA Section 1201(f) interoperability exemption. It also warns that knowingly misrepresenting such projects as infringing can make the claimant liable under Section 512(f).
It argues suyu does not circumvent Nintendo's technological protection measures: users supply their own games and keys, decryption relies on the public AES standard, and the project claims the DMCA Section 1201(f) interoperability exemption. It also warns that knowingly misrepresenting such projects as infringing can make the claimant liable under Section 512(f).What are similar projects?Fable-2-Recomp, KytyPS5, dolphin, Yakumo, TheSimpsonsGameRecomp, rpcs3, duckstation, shadPS4
Fable-2-Recomp, KytyPS5, dolphin, Yakumo, TheSimpsonsGameRecomp, rpcs3, duckstation, shadPS4