r/switch2hacks • • 5d ago • Bravo 1

Hacking News GitHub Essentials

Post image

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. ❀️

277 Upvotes

61 comments sorted by

11

u/Important_Memory3732 5d ago

Love u 🫢🏻

2

u/starina988 5d ago

πŸ™

7

u/Leusele_Louis 5d ago

Pls keep updating this, this is huge πŸ‘πŸ‘πŸ‘πŸ‘€

3

u/starina988 5d ago

I will do it as things start to come out :)

6

u/kubbie2004 5d ago

Saves me lots of time hunting them down. A big THANK YOU!

3

u/starina988 5d ago

You're welcome :)

3

u/VibeSoftwareCoder_GH 5d ago

So is SB4 not used anymore?

1

u/starina988 5d ago

CiV is better i think πŸ˜…

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

Of course. When I have some free time I will be adding descriptions and restructuring everything :)

2

u/ozzzmaaa 4d ago

Thank you!

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/starina988 5d ago

We haven't reached that point yet. Everything is in development and the devs are working hard :)

1

u/DXGL1 4d ago

Wouldn't that require kernel-level takeover?

1

u/starina988 4d ago

yep, 100%

1

u/DXGL1 4d ago

And if SciresM's analysis still holds true that would require a boot ROM exploit to pull off?

1

u/starina988 4d ago

Exactly. We don't yet have the necessary permits to achieve this type of thing. It can take a long time. Just be patient.

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

1

u/starina988 5d ago

You're right, I realized it a while ago but I haven't updated it yet. Thank you very much for the notice!

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!

1

u/starina988 5d ago

You're welcome friend :)

2

u/Ok_Silver5926 5d ago edited 5d ago • Bravo

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

1

u/starina988 5d ago

Congratulations on this great work! And thank you to you for everything that goes behind it and for the amount of time that a project like this takes. πŸ™

Of course I will keep asking if I have any doubts. I plan to restructure this post better and add brief explanations from the developers that help in the future, especially for the most inexperienced ones.

Nice to see you around here and thank you very much for everything ❀️

2

u/Ok_Silver5926 5d ago

I’d like to also say that I recently figured out how to get the game to run at max cpu clock speed (1702 MHz) and am working on fixing some frame stutter / minor performance issues rn. Anyhow, if you have any questions about the project, just lmk!

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/starina988 4d ago

I'll add it too. Thank you for the information :)

2

u/JustLilNeko 1d ago

1

u/starina988 1d ago

It was already added πŸ˜…

3

u/JustLilNeko 1d ago

its the actual repo though not the PR

2

u/starina988 1d ago

added 🫑

2

u/MarioMasta64 1d ago

time to update it again

1

u/starina988 1d ago

This is progressing very fast and many things are coming out. I will be adding little by little.πŸ˜…

2

u/ProtectionWeird7968 22h ago

Disclaimer goated

1

u/starina988 22h ago

πŸ™

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 :)

2

u/starina988 18h ago

Actually, it's the method I use. I thought I had put it there. As soon as I have time, I'll update it. I'm a bit busy right now πŸ˜… thx πŸ™

1

u/Nerisma 18h ago

No worries, thanks for keeping up with that list πŸ‘

6

u/Webteasign 5d ago

Think we should pin this post no?

2

u/Important_Memory3732 5d ago

True ‼️

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?

2

u/starina988 4d ago

Lula is working on it if I'm not mistaken. For now, don't do anything in the experimental phase :)

1

u/burneraccburneracc 4d ago

Ah ok. So the B guide in the GitHub
isn't recommended or just for people with CivSwitch already?

1

u/starina988 4d ago

In CiV the current success rate is 90%. Personally, I prefer not to do anything until everything is polished to 100%.

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?

1

u/starina988 1d ago

It was in English, but by mistake I updated the post with the Spanish translation enabled. It's already fixed πŸ˜…

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.

3

u/KotaruTWK 2d ago

Lmk too

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? 🍻