If you’re trying to Add NSZ Switch Games to Ryujinx, you’ve probably noticed they don’t launch the way NSP or XCI files do. That’s because NSZ files are compressed and need a quick conversion before the emulator can read them.
In this guide, you’ll learn how to play NSZ files on Ryujinx Windows without errors, using simple and reliable methods.
We’ll cover the exact process of Ryujinx NSZ to NSP conversion, including tools like SAK NSZ to NSP, so you can get your games running smoothly.
Whether you’re new to emulation or just stuck with unsupported file formats, this step-by-step approach will help you fix the issue quickly and correctly.
Top 12 Ways to Fix Ryujinx Crashing Or Freezing Issues on Game Launch
What Is an NSZ File and Why Doesn’t It Work
NSZ was developed by Nicoboss and others in the Switch community as a way to compress large NSP files into smaller archives. Same game data, smaller footprint. Great for storage. Useless until you decompress it.
Think of it like a ZIP file. You wouldn’t try to install a ZIP directly. Same idea.
You can think of it like this:
NSZ = compressed package
NSP = actual installable file
Ryujinx only understands NSP and XCI formats, which means it needs the full, uncompressed data to run games. That’s why NSZ files fail to load—they’re not in a readable format for the emulator.
Understanding the Current State of Ryujinx
Worth saying upfront: the original Ryujinx emulator shut down in October 2024 after Nintendo pressured the lead developer into taking it down. The project’s GitHub was wiped.
A fork called Ryubing is now the main continuation, hosted at git.ryujinx.app after leaving GitHub. That’s the version most people are running now. The steps below apply to both the last official build (1.1.1403) and Ryubing.
Method 1: Convert NSZ to NSP Using Switch Army Knife (SAK)
If you prefer a simple and beginner-friendly method, Switch Army Knife (SAK) is the easiest option. It provides a graphical interface, so you don’t need to deal with commands.
Steps:
- Download the latest version of Switch Army Knife (SAK)
- Extract the ZIP file and open SAK.exe
- Select the option NSZ → NSP Conversion
- Click Browse and choose your NSZ file
- Select an output folder where the NSP will be saved
- Click Convert and wait for the process to finish
Once done, you’ll find your converted NSP file in the selected folder. This file is now ready to use in Ryujinx.
Note: SAK is mainly designed for Windows users. If you’re on Mac or Linux, you may need alternative tools or compatibility layers.
Method 2: Convert NSZ Using NSZ Tool (Faster & Advanced)
For users who want better performance and flexibility, the NSZ command-line tool is a solid option. It’s faster and works across multiple platforms.
Basic Command:
nsz -D your_game.nszThis command decompresses the NSZ file and creates an NSP version in the same directory.
Batch Conversion (Optional):
nsz -D /your/folder/path/This is useful if you have multiple NSZ files to convert at once.
After conversion, you’ll have a proper NSP file ready for installation.
How to Add the Converted NSP File to Ryujinx
Once your NSP file is ready, adding it to Ryujinx is straightforward.
Method 1: Add Game Directory
- Open Ryujinx
- Go to Options → Settings
- Click Add under Game Directories
- Select the folder containing your NSP file
Your game will now appear in the library.
Method 2: Install to NAND
- Open Ryujinx
- Go to File → Install Files to NAND
- Select your NSP file
- Wait for installation
After installation, the game will be available to launch directly.
Common Issues and Real Fixes
Game Not Showing in Library
This usually happens if the folder path is incorrect. Double-check your directory settings and restart Ryujinx.
Conversion Failed or Stuck
If the conversion tool freezes or fails:
- Restart the tool
- Try another converter (SAK or NSZ tool)
- Check if the NSZ file is corrupted
Key Errors (Missing Prod Keys)
Errors like “NCA Header key not found” indicate outdated or missing keys. Update your prod.keys file to fix this.
Game Crashes After Launch
This is not related to NSZ anymore. Check:
- Firmware version
- Emulator version
- GPU drivers
Tips for Better Performance and Stability
- Always use the latest Ryujinx version
- Keep firmware and prod. keys updated
- Convert files using reliable tools
- Avoid mixing regions (USA, EU, Japan)
- Delete NSP after installation to save space
Quick Summary (Simple Flow)
- NSZ file = compressed format (not supported)
- Convert NSZ → NSP
- Add or install NSP in Ryujinx
- Launch and play
That’s it. No shortcuts, no extra tricks.
How to Fix “Ryujinx Is Not Intended to Be Run as Administrator”
Final Thoughts
NSZ files are not broken—they’re just compressed. Once you convert them properly, they work exactly like any other game file in Ryujinx.
If you follow the steps above carefully, you won’t run into issues. Most problems come from skipping conversion or using incorrect files.
