r/switch2hacks
•
u/starina988
•
5d ago
•
1
Hacking News GitHub Essentials
GitHub Essentials β Nintendo Switch 2 Homebrew, Tools, Emulators & Native Ports
Hey everyone! π
A few days ago, I put together a collection of GitHub repositories related to the Nintendo Switch 2 homebrew scene.
Since then, development has been moving incredibly fast. Weβve seen the release of kaiHEN, new homebrew applications, emulators, native game ports, improved exploit launchers, and several other interesting projects.
Iβve decided to completely restructure and expand the original collection to make everything easier to find, especially for newcomers.
Everything is now organized into categories, with a short explanation of what each project does and direct links to its repository.
Important: Most of these are experimental and under active development. Some require specific firmware versions, existing entry points, additional hardware, or manual compilation. Always read the documentation before attempting anything.
βββββ
1. kaiHEN β Core Environment & Development
kaiHENζΉε€ β Homebrew Environment (WIP)
kaiHEN
https://github.com/ouncebrew/kaihen
The main homebrew environment for Nintendo Switch 2. It allows compatible native homebrew applications to run and provides additional system-level functionality.
WARNING: This is experimental software with potentially dangerous access to system storage. Incompatible or malicious applications could permanently damage your console.
Ounce Devkit β Development Toolkit
https://github.com/ouncebrew/ounce-devkit
A development toolkit for creating and porting native Switch 2 homebrew. It includes tools and libraries associated with the ouncebrew ecosystem, helping developers adapt existing Switch homebrew projects.
Ounce HBMenu β Homebrew Menu
https://github.com/ouncebrew/ounce-hbmenu
A homebrew launcher for the ouncebrew environment. It provides an interface for accessing compatible homebrew applications and is also the target of ongoing integrations such as Brewstore.
Ozone β Experimental System Environment
https://github.com/alula/Ozone
An experimental project adapting Atmosphère-related components to the Switch 2 Ounce environment.
Its goal is to simplify future homebrew development and system module porting.
This is not a complete, production-ready custom firmware.
ββββββ
2. Exploits, Entry Points & kaiHEN Launchers
CivSwitch β Civilization VII Entry Point
CiVSwitch
https://github.com/Gezine/CivSwitch
A JavaScript execution entry point using the Nintendo Switch 1 version of Civilization VII running on Switch 2.
It serves as the foundation for several homebrew applications, filesystem tools, and exploit chains.
ns2jb β SmileBASIC 4 Entry Point
https://gitlab.com/kurumuz/ns2jb
An exploit chain that uses SmileBASIC 4 to execute code on Nintendo Switch 2.
One of the original entry points used to launch experimental homebrew and kaiHEN.
Civ7 FS kaiHEN β Filesystem Exploit
https://github.com/s8n/civ7-fs-kaihen
A Civilization VII-based filesystem exploit chain designed to launch kaiHEN.
It provides filesystem access and the additional exploitation stages needed to initialize the homebrew environment.
CivSwitchFS-kaiHEN β Alternative Development Branch
https://github.com/s8n/CivSwitchFS-kaiHEN/tree/slop
A development branch of the Civilization VII filesystem exploit and kaiHEN setup.
It includes experimental changes to the installation and exploitation process.
kaiHEN Fast β Installer & Autoloader
https://github.com/yyoossk/kaihen-installer
An installer designed to simplify the process of launching kaiHEN through Civilization VII.
The project also includes an autoloader intended to reduce dependence on a PC after the initial setup.
Seedsow FS kaiHEN β Seedsow Lullaby Entry Point
https://github.com/Malev0/seedsow-fs-kaihen
An alternative method for launching kaiHEN using Seedsow Lullaby.
It provides a PC-controlled exploit workflow with automation and retry functionality, offering another possible entry point for compatible setups.
seedsow-port-kit β Seedsow Filesystem Toolkit
https://github.com/ninjadudexp/seedsow-port-kit
A toolkit exploring Seedsow Lullaby as an alternative route to filesystem access.
It can also serve as an additional development or backup method for users already working with Civilization VII-based exploits.
Civ7 FS Cleaned β Modified Filesystem Exploit
https://github.com/HerXayah/civ7-fs
An experimental modification of the Civilization VII filesystem exploit, with changes intended to improve reliability and simplify parts of the execution process.
mac2jb β macOS Exploit Toolkit
https://github.com/cpypwn/mac2jb
An all-in-one macOS toolkit that brings together several Nintendo Switch 2 exploit and homebrew workflows.
It supports SmileBASIC and Civilization VII-related methods, along with an experimental launcher, save-management utilities, and filesystem tools.
Primarily intended for Apple Silicon Macs.
ββββ-
3. Networking, Payload Delivery & File Management
ESP32 CivSwitch Serial Bridge β Isolated Network Bridge
https://github.com/jackspence7/CivSwitch-
SerialBridge
A bridge that uses an ESP32 to communicate with a PC over USB while providing a separate Wi-Fi network for the console.
Useful for delivering CivSwitch payloads without connecting the console to the PCβs regular Wi-Fi network.
Pico 2 W CivSwitch Serial Bridge β Raspberry Pi Alternative
https://github.com/favas0/CivSwitch-Pico2W-SerialBridge
An alternative implementation for the Raspberry Pi Pico 2 W.
It communicates with a PC over USB and creates an independent wireless access point for the console.
Useful for users who want a dedicated local connection for payload delivery.
OunceCake-Civ7 β RomFS & ExeFS Dumper
https://github.com/BlafKing/OunceCake-Civ7
A Civilization VII-based utility for dumping decrypted RomFS and ExeFS data from Nintendo Switch 2 games, updates, and DLC.
Useful for research, reverse engineering, and examining game resources.
KaiDrop β PC-to-Switch 2 File Transfer
https://github.com/mizuiroame/kaidrop
A Windows file-transfer utility designed for Nintendo Switch 2 running kaiHEN.
It provides a FileZilla-style interface and automatically sanitizes filenames containing unsupported characters.
Particularly useful for transferring music, folders, and homebrew files without running into filename visibility issues.
βββββ
4. Homebrew Launchers, Frontends & Utilities
Sphaira β Alternative Homebrew Menu
https://github.com/NaGaa95/sphaira
A homebrew launcher and file-management frontend ported to Nintendo Switch 2.
The kaiHEN-compatible version provides a more advanced interface for accessing homebrew applications.
Current limitations: Several features remain unavailable, including game installation, forwarders, Game Card functions, USB/MTP integration, and Themezer.
CivHomebrew β Civilization VII Homebrew Launcher
https://github.com/XITRIX/CivHomebrew
A homebrew launcher built around CivSwitch.
It allows users to organize and launch compatible .civapp applications through the Civilization VII entry point.
An important earlier approach to Switch 2 homebrew, although newer applications are increasingly moving toward native .nro builds for kaiHEN.
Brewstore β Homebrew Store (In Development)
https://github.com/HerXayah/brewstore
https://github.com/ouncebrew/ounce-hbmenu/pull/1
An experimental homebrew store concept using a repository-based distribution system.
Designed to allow developers to define installation instructions through JSON and provide convenient application shortcuts.
Note: The linked page is the HBMenu integration proposal. The announcement did not include a public Brewstore repository.
Switch 2 Language Experiment β System Language Utility
https://github.com/hrvtuirvw/switch2-language-experiment
An experimental JavaScript-based utility for changing the system language on Japanese Nintendo Switch 2 consoles.
It includes multiple language options and a method for restoring the original Japanese configuration.
ββββ
5. Emulators
RetroArch β Multi-System Emulation Frontend
https://github.com/NerdsMcGee/retroarch-s2
A native RetroArch port for Nintendo Switch 2 using the kaiHEN environment.
It brings the familiar RetroArch interface and compatible emulation cores to Switch 2.
Compatibility and performance depend on the specific core, build, and current development status.
SW2NES β Nintendo Entertainment System Emulator
https://github.com/Rodpad/SW2NES
Latest release:
https://github.com/Rodpad/SW2NES/releases/tag/v2.12.1
A dedicated NES emulator now distributed as a native .nro for HBMenu/kaiHEN.
Features include:
Nestopia UE and QuickNES emulation cores
Full-speed NES emulation
Two-player support
Game Genie cheats
Save states
CRT shaders and display filters
Low-latency rendering and run-ahead
120 Hz and VRR support
IZPSX β PlayStation Emulator
https://github.com/byizmysh/IZPSX-emulator
A PlayStation 1 emulator developed for Nintendo Switch 2.
It supports games stored on external storage, persistent memory cards, and multiplayer functionality.
Requires the associated IZ2S platform and compatible filesystem access.
Cemu-NX2 β Wii U Emulation Project
https://github.com/TheAJLive/Cemu-NX2
A Nintendo Switch 2-oriented Cemu repository exploring Wii U emulation on the console.
Experimental: The availability of working builds, compatibility, and performance should be checked directly in the repository. This listing does not imply that Wii U games are currently playable at full speed.
βββββ-
6. Native Game Ports & Recompilation Projects
Mario Kart Wii β WiiCompiled / Retro Rewind
https://github.com/6rimson/WiiCompiled-Switch2
An experimental Nintendo Switch 2 port of Mario Kart Wii using static recompilation rather than conventional emulation.
Recent development updates include:
Native launching through kaiHEN/HBMenu
Support for standard microSD and microSD Express cards
Offline gameplay after launching the application
Mostly 60 FPS racing performance
Improved menu responsiveness
Functional Plus-button pause support
Adjustable CPU, GPU, and memory clocks
The developer has also reported reaching a CPU clock speed of 1702 MHz and continues working on frame pacing and performance improvements.
Requires your own PAL Mario Kart Wii game data (RMCP01).
PokΓ©mon Platinum β Decompilation-Based Port
https://github.com/cybervisi0n/pokeplatinum
A PokΓ©mon Platinum decompilation project demonstrated running on Nintendo Switch 2 through kaiHEN.
An interesting example of how decompilation and native porting efforts can bring classic Nintendo games to new hardware.
Check the repository for build instructions and current limitations.
GTA V Recomp β Experimental Recompilation Project
https://github.com/itsPLK/gtav-recomp-nx2
An experimental Grand Theft Auto V recompilation project targeting Nintendo Switch 2.
Included for development tracking and research purposes.
This should not be interpreted as confirmation of a fully playable native GTA V port.
ββββ
7. Streaming & Multimedia Applications
Moonlight-CivSwitch β PC Game Streaming
https://github.com/XITRIX/Moonlight-CivSwitch
A Moonlight client for Nintendo Switch 2 using CivSwitch.
It allows users to stream games and desktop applications from a PC running Sunshine.
Includes support for controller input, video, audio, and touchscreen interaction.
Moonlight-nx2 β Alternative Moonlight Project
https://gitlab.com/Azkali/moonlight-nx2
An alternative Moonlight-related project targeting Nintendo Switch 2.
Originally listed as awaiting further kaiHEN development. Check the repository for its current progress and compatibility.
Jellyfin β Media Streaming Client
https://github.com/THZoria/jellyfin
An unofficial Jellyfin client for accessing personal media libraries from Nintendo Switch 2.
Designed for streaming movies and TV shows from a Jellyfin media server.
YAJA β Yet Another Jellyfin App
https://github.com/porkchopkilla/YAJA-yet-another-jellyfin-app-
An alternative Jellyfin client with a different implementation and user experience.
Worth comparing with the other Jellyfin project depending on your preferred interface and supported features.
KaiPlayer β Native Music Player
https://github.com/mizuiroame/kaiplayer
A feature-rich music player developed for Nintendo Switch 2 and kaiHEN.
Features include:
Artist, album, and track libraries
Album artwork and metadata
Playlist support, including M3U8
Ten-band equalizer
ReplayGain
MP3, FLAC, Ogg Vorbis, and WAV playback
DSD/DSF conversion to PCM during playback
Custom backgrounds and accent colors
Vinyl, CD, and cassette-style visualizations
Touchscreen support
Sleep timer
Improved GPU rendering for docked displays
ββββ-
8. Important Information for Newcomers
Is kaiHEN a complete custom firmware?
No. Although it provides significant homebrew capabilities and low-level access, it should not be confused with a mature, fully featured custom firmware environment.
Can I run any Nintendo Switch 1
.nro application?
Not automatically. Applications may need to be rebuilt or adapted using Switch 2 development libraries. Some require additional graphics, audio, or system-level changes.
Can I install commercial Switch 2 games through kaiHEN?
The existence of filesystem access and native homebrew support does not automatically mean that commercial games can be installed or executed.
Do all projects work on every firmware?
No. Compatibility varies between entry points, exploit chains, and individual applications. Always check the specific repository before attempting installation.
Do I need to connect my console to Nintendoβs servers?
Not necessarily. Some workflows support local-only connections or offline operation.
However, a local Wi-Fi connection, Airplane Mode, or custom DNS configuration should not be treated as a universal guarantee against unwanted network communication.
Are these projects safe?
There is always some risk when running experimental software with low-level system access.
Back up important data whenever possible, read the documentation, and avoid running unfamiliar binaries without understanding what they do.
Credits & Final Notes
All credit goes to the original developers, contributors, and researchers behind these projects.
Iβm not affiliated with any of them. Iβm simply collecting publicly available information to make it easier for everyone to discover useful tools and follow the progress of the Nintendo Switch 2 homebrew scene.
A huge thank you to everyone who contributed repositories, corrections, and additional information to the original post.
Iβll keep updating this collection as new projects appear and existing ones receive important updates.
If youβre a developer and notice that something is inaccurate or outdated, feel free to leave a comment.
Likewise, if you know of any useful repositories that arenβt listed here, share them below and Iβll take a look.
Thanks to all the developers pushing this scene forward. The amount of progress in such a short time has been incredible. β€οΈ
11
u/Important_Memory3732 5d ago
Love u π«Άπ»
7
u/Leusele_Louis 5d ago
Pls keep updating this, this is huge ππππ
6
u/kubbie2004 5d ago
Saves me lots of time hunting them down. A big THANK YOU!
3
u/FullMetalMaster14 5d ago
GOAT
3
u/VibeSoftwareCoder_GH 5d ago
So is SB4 not used anymore?
3
u/ozzzmaaa 4d ago
Could you add descriptions for the repos so the unitiated can understand the purpose of the tools a bit better?
2
u/starina988 4d ago
UPDATE: Short descriptions of each utility have been added :)
2
u/EventPuzzleheaded124 5d ago
What's the current status of the mod? Can I run .nsp rom files yet? Because my Switch 2 is offline and I can't run any games other than cartridges.
2
u/favas0 5d ago
Hi the pico 2 w link is actually for a raspberry pi setup. Which is totally different. Not to brag here but here you go
https://github.com/favas0/CivSwitch-Pico2W-SerialBridge
2
u/uberduger 5d ago
Amazing, thanks! Been trying to download them every time I see but now have a mishmash across my phone and 2 computers I use lol.
Guess I should get a Git account and start bookmarking as I DL!
2
u/Deathjijn 5d ago
you forgot to add ozone GitHub - alula/Ozone: turbo experimental "custom firmware" for Switch 2 Β· GitHub
2
u/Ok_Silver5926 5d ago edited 5d ago •
Thank you for linking my WiiCompiled port :)
I recently added microSD support (both regular and Express) so you are now able to play untethered on WiFi or Airplane mode after launching the game from HBLauncher
2
u/MarioMasta64 4d ago
btw this one [ https://github.com/porkchopkilla/YAJA-yet-another-jellyfin-app- ] is a better version of this one [ https://github.com/THZoria/jellyfin ] by a long shot
2
u/JustLilNeko 1d ago
https://github.com/HerXayah/brewstore
fyi
2
u/MarioMasta64 1d ago
time to update it again
2
u/ProtectionWeird7968 22h ago
Disclaimer goated
2
u/Nerisma 18h ago edited 6h ago
https://github.com/s8n/CivSwitchFS-kaiHEN now has merged the development branch and is (I believe) the only fully stable semi-unthetered version giving access to kaiHEN :)
6
u/Webteasign 5d ago
Think we should pin this post no?
1
u/burneraccburneracc 4d ago
Let me get this straight. If your only entry point is nora2hax / seedsow is there still no rw? Or is it just really experimental?
3
u/Cunter_Peniston 5d ago
β€οΈ
3
u/stoopeeed 12h ago
How long until I get banned
1
u/P529 1d ago edited 1d ago
Can we maybe have this in english too?
2
u/Davidkb10 20h ago
new Hb compatible of Kaihen:
Toolkit: https://github.com/davidkalil10/NS2ToolKit
Games:
- https://github.com/davidkalil10/Heroes-Lore-3-Stigmata-of-Gaia
- https://github.com/davidkalil10/BattleShip-remix-NS2
Apps:
- Geforce now client https://github.com/davidkalil10/Switch2NOW
- xcloud client https://github.com/davidkalil10/green-nx_switch-2
- iptv client https://github.com/davidkalil10/switch2iptv
2
u/Mees19 1d ago
I have both civ7 and the first seedsow save and now iβm quite lost on where to go next tbh. Can anyone redirect me on what to do first
2
u/BlessedAreTheRich 2d ago
I only want to play Switch 2 NSPs. Wake me up when that happens.
1
u/cheongzewei 5d ago
Er, anyone knows what's the git for smilebasic?
1
u/ThisIsHansen 3d ago
Anyone get FS working on 22.5.0?
0
u/Intelligent_Put_1159 3d ago
this is great! one question, what exactly does the seedsow-port-kit do? does it give seedsow the same power as civ7?
3
u/Late_Salary_5316 5d ago
So Nintendo can find and nuke them more easily? π»