Skip to content
RodpadPublic

About

Super Nintendo emulator (Snes9x) for Nintendo Switch 2 hbmenu under kaiHEN

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

SW2SNES

A Super Nintendo emulator for the Nintendo Switch 2, running as a homebrew app from hbmenu under kaiHEN. It uses the Snes9x core with the SW2NES front end: native C++ with OpenGL ES, built with devkitPro and the Switch 2 devkit (ounce-devkit).

No game ROMs are included or provided.

Installing

  1. Set up kaiHEN on your Switch 2 so that hbmenu runs.
  2. Copy sw2snes.nro from the latest release to /switch/sw2snes/sw2snes.nro on the SD card.
  3. Copy your games (.sfc, .smc, .fig, .swc or .zip) to /roms/snes on the SD card. SW2SNES creates this folder on its first launch. A different folder can be chosen in Settings > ROM folder.
  4. Launch SW2SNES from hbmenu.

Settings, saves and play time are kept in /switch/sw2snes/ on the SD card.

Updating

Replace /switch/sw2snes/sw2snes.nro with the one from the newest release. Settings, saves, save states and play time are kept in /switch/sw2snes/ and are not touched by an update. (Close SW2SNES on the console before uploading over FTP; a running app's file cannot be replaced.)

Features

  • Snes9x (libretro), including its enhancement-chip support (SuperFX, SA-1, DSP-n, CX4, S-DD1, SPC7110 and others)
  • Hi-res and interlaced modes (512 wide, 448/478 high)
  • Low input latency: one frame in flight, run-ahead (1–2 frames), frame delay at 60 Hz
  • 120 Hz / VRR on the Switch 2 screen
  • Rewind (hold ZL) and fast-forward (hold or toggle ZR)
  • GPU shaders: CRT-Royale (lite), CRT-Geom, CRT-Lottes, CRT-Easymode, CRT-Aperture, zfast CRT, LCD grid, Scale2x, sharp bilinear, bilinear
  • NTSC signal simulation (composite, composite with dot crawl, S-Video)
  • Curvature, rounded corners, vignette and brightness boost
  • Aspect ratio, integer or fit scaling, overscan
  • 4 save-state slots per game, battery saves, optional auto-load of the latest state
  • Two players, with separate button mapping and turbo for each
  • Game Genie and Pro Action Replay codes (on-screen editor)
  • Favourites, recently played and time played per game
  • Zipped ROMs (.zip with a .sfc/.smc inside)
  • Per-game or global settings; advanced options can be hidden

Controls

Switch 2 SNES / app
D-pad / left stick D-pad
A, B, X, Y SNES A, B, X, Y (default)
L, R SNES L, R (default)
+ / − Start / Select
ZL + ZR In-game menu (press again to close)
ZL (hold) Rewind
ZR Fast-forward

Buttons can be remapped per player in Settings, including turbo.

In the game list: Y opens Settings, X refreshes the list, B exits, and L/R or ZL/ZR switch between All, Favourites and Recent.

Building

Requirements: devkitPro pacman with switch-dev, switch-freetype and switch-zlib, and the Switch 2 devkit (sh install.sh from ounce-devkit).

export DEVKITPRO=/opt/devkitpro
make

This builds sw2snes.nro. tests/host_build.sh builds a host (Mac/Linux) test of the core bridge under AddressSanitizer.

Layout

Path Contents
source/ The app: menus, settings, game loop, video (OpenGL ES), audio, input, rewind
romfs/shaders/ Picture shaders (GLSL ES) and the NTSC encoder/decoder
native/bridge_snes9x.cpp C interface to Snes9x (frames, audio, states, cheats)
third_party/snes9x Snes9x (from libretro/snes9x, see SOURCE.txt)
tests/ Host tests for the core bridge
licenses/ Licences of the bundled components (also inside the app)

Licence

SW2SNES's own code (everything outside third_party/) is under the MIT licence (see LICENSE). Snes9x is not free software for commercial use: its licence allows free non-commercial use and distribution only, so SW2SNES as a whole may only be used and distributed non-commercially. See licenses/snes9x-LICENSE.txt.

It also includes:

  • libretro-common (MIT)
  • Roboto (Apache 2.0) and Source Code Pro (SIL OFL 1.1) fonts
  • libounce and libnx (ISC), libkaihen (ISC), OunceVK / Mesa (MIT), mimalloc (MIT), FreeType (FTL), HarfBuzz (MIT), libpng, zlib, minizip (zlib licence) and bzip2

Their licence texts are in licenses/.

About

Super Nintendo emulator (Snes9x) for Nintendo Switch 2 hbmenu under kaiHEN

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages