October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Use Ryujinx Emulator on PC: Beginner Setup Guide

A current beginner guide to installing and using Ryujinx on PC, including keys, firmware, game folders, controller setup, graphics, caches, DLC, mods and saves.
Length8 min Posted Quest giverVGSources Team

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To use Ryujinx on a PC, download the current Stable build, verify the archive, extract it to a writable folder, provide keys and firmware dumped from hardware you own, add your legally obtained game files, then configure a controller and graphics backend. The current download page lists Stable v1.3.3 from the May 2026 channel and Canary v1.3.295; Stable is the safer choice for beginners because Canary is experimental.

Ryujinx requires your own prod.keys, title.keys where required, firmware, and game content. Do not download these files from third-party “keys” sites or use repacked emulator bundles.

As an Amazon Associate I earn from qualifying purchases.

What you need before installing Ryujinx

  • A Windows 10 or 11 PC. The current build page lists Windows 10/11 support; older detailed documentation specifies Windows 10 version 1803 (10.0.17134) or newer.
  • At least 8 GB of RAM; 16 GB is recommended for demanding games.
  • A GPU supporting Vulkan 1.1+, OpenGL 4.5+, or a compatible Metal renderer. Older documentation lists Vulkan 1.2 or newer as the stricter baseline.
  • Current graphics drivers.
  • Keys, firmware, and game files dumped from hardware and software you own.

Ryujinx is currently distributed for Windows x64, Linux, and macOS. This guide focuses on Windows, where the downloadable package is a ZIP archive. Check the official download page for current builds and platform packages.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

1. Download and verify Ryujinx

Download Stable unless you specifically want to test experimental changes. Canary builds can contain regressions and are not the best starting point for troubleshooting.

#1 Best Overall
8Bitdo Ultimate 2C Wireless Controller for Windows PC and Android, with 1000 Hz Polling Rate, Hall Effect Joysticks and Triggers, and Remappable L4/R4 Bumpers (Green)
  • Compatible with Windows and Android.
  • 1000Hz Polling Rate (for 2.4G and wired connection)
  • Hall Effect joysticks and Hall triggers. Wear-resistant metal joystick rings.
  • Extra R4/L4 bumpers. Custom button mapping without using software. Turbo function.
  • Refined bumpers and D-pad. Light but tactile.

Download only from the official Ryujinx site. Fake download pages may distribute modified binaries or adware, and generic antivirus detections can occur because unsigned emulator files may be uncommon or have a low reputation score. A warning alone does not prove that a file is malicious, but do not create an antivirus exclusion until you have verified the download.

On Windows, open Command Prompt in the folder containing the archive and run:

certutil -hashfile Ryujinx.zip SHA256

Compare the result with the SHA-256 hash published for that exact archive on the download page. If it does not match, delete the file and download it again. Do not run a repacked or cracked bundle.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. Install Ryujinx on Windows

Ryujinx uses an extracted, portable-style installation rather than a conventional installer.

  1. Open the downloaded ZIP.
  2. Extract the contents of its publish folder to a location you control, such as C:GamesRyujinx.
  3. Avoid extracting it to the Desktop or the root of a drive. Windows permissions can interfere with files written there.
  4. Run Ryujinx.exe.
  5. If Windows displays a security warning for the first launch, use Run anyway only after confirming that you downloaded and verified the official archive.

On first launch, Ryujinx creates its normal data directory at:

%appdata%Ryujinx

This directory contains configuration, firmware, save data, shader caches, and other emulator data. If Windows asks for it, install the .NET Desktop Runtime required by the build.

3. Install your keys

Ryujinx needs encryption keys dumped from your own Nintendo hardware. The project documentation refers to prod.keys and title.keys; the exact files required can depend on the content and firmware generation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The documented manual method is:

  1. In Ryujinx, choose File > Open Ryujinx Folder.
  2. Open the system folder.
  3. Copy your legally dumped key files into that folder.
  4. Restart Ryujinx so it can validate the keys.

The Windows path is:

%appdata%Ryujinxsystem

Some current builds expose key installation through the Actions menu instead. Use that installer if it is available; menu names can differ between Stable, Canary, and frontend revisions. Do not download keys from websites offering “latest” or “preconfigured” key packs.

Rank #2
Sale
ManbaOne Interactive Screen Wireless Gaming Controller (Black)
  • Supported Multi-Platform:Switch/Switch 2 (NO support wake-up function)/iOS/Android/Windows PC (Notice:Not compatible with Xbox, PlayStation or GeForce Now, For game platforms not mentioned, please consult customer service before buying)
  • Connection modes:Wired/Bluetooth/Wireless Dongle(Connect to PC via Bluetooth : Select iOS (phone) mode, but it's not recommended; Dongle is more stable)
  • 【Innovative Intelligent Interactive Screen】Manba One V2 wireless game controllers create a new era of controller screens; Equipped with a 2-inch display, no App & software needed, you can set the pc controller directly through the screen visualization, More convenient operation
  • 【Micro Switch Button】Manba One wireless controller has Micro Switch Button and ALPS Bumper; The 6-axis gyroscope function makes switch games more immersive
  • 【Customize Your Own Controller】The intelligent interactive screen allows you to easily set vibrations, buttons, joysticks,lights, etc., without the need for complex key combinations; 4 configurations can be saved to unlock your own gameplay for different games; The 4 back keys support macro definition settings, and you can activate the set character's ultimate move with one click

4. Install firmware

Firmware must also come from your own hardware. In the documented Windows workflow, open:

Tools > Install Firmware > Install from XCI/ZIP

Select an untrimmed firmware XCI or a firmware ZIP, confirm with Yes, and dismiss the success message with OK. The installed version appears as System Version in the lower-right corner of the main window.

Other current builds may expose firmware installation through a slightly different menu and may accept a ZIP, folder, or XCI. Choose the firmware-installation entry shown by your build rather than assuming every version has identical labels.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The keys must be at least as new as the firmware you are installing. If installation fails with missing-key or generation-mismatch errors, use a compatible key set dumped from your own updated system rather than downloading replacement files.

5. Add your games

Ryujinx scans folders containing supported game files, including NSP, XCI, and NCA formats. It can display title IDs, versions, and play status, but you must supply content you are entitled to use.

  1. Open Options > Settings.
  2. Stay on the User Interface tab.
  3. Enter the absolute path to the folder containing your game files and click Add. Alternatively, leave the field empty, click Add, and select the folder in the file picker.
  4. Click Save.

Add the folder, not an individual game file. If the library remains empty, confirm that the selected directory actually contains supported files, that keys and firmware are installed, and that the files were not damaged during transfer.

6. Configure a controller

Connect your controller before opening the input settings. Then go to:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Options > Settings > Input
  1. Select the appropriate controller slot.
  2. Choose the controller from the Input Device dropdown.
  3. Map the buttons and sticks.
  4. Click Apply, then OK.

Docked Mode changes which slot you configure. With Docked Mode enabled, configure Player 1. With it disabled, configure Handheld.

Rank #3
GameSir G7 Pro Wired Controller for Xbox Series X|S, Xbox One, Wireless Gamepad for PC&Android with TMR Sticks, Hall Effect Analog Triggers, 1000Hz Polling Rate, 3.5mm Audio Jack - Black
  • Tri-mode Connectivity: Wired for Xbox, 2.4G & Wired for PC, and Bluetooth for Android. The G7 Pro supports seamless connectivity across Xbox, PC, and Android. Effortlessly switch between modes using the convenient physical mode switch.
  • TMR Sticks: The G7 Pro features GameSir's Mag-Res TMR sticks, combining Hall Effect durability with traditional potentiometer performance. This advanced technology delivers stable polling rates for smooth, drift-free gaming with low power consumption.
  • Hall Effect Analog Triggers: The GameSir precision-tuned Hall Effect analog triggers provide unmatched smoothness and linear input for precise control. Featuring clicky Micro Switch trigger stops, gamers can easily switch based on their preferences.
  • 1000Hz Polling Rate on PC: Experience ultra-responsive gaming with a 1000Hz polling rate on PC, available through both wired and 2.4G wireless connections. This ensures instantaneous input registration, reducing lag and optimizing your performance for the most competitive gameplay.
  • GameSir Nexus App: The G7 Pro is compatible with the upgraded GameSir Nexus app, which brings a significant upgrade over the original. It introduces powerful new features such as gyro settings, stick curve adjustments, and button-to-mouse mapping, giving you deeper customization and more control than ever before.

The default joystick deadzone is 0.10. If the character or camera moves without touching the stick, increase it to at least 0.20 and test again. If an XInput controller does not appear, an XInput wrapper or translator such as x360ce may be necessary.

Leave Direct Keyboard Access and Direct Mouse Access disabled unless you specifically need Ryujinx to expose those devices as USB-connected Switch peripherals.

7. Choose graphics settings

Open:

Options > Settings > Graphics

Use the following starting points:

  • Vulkan: generally recommended on modern NVIDIA and AMD GPUs.
  • OpenGL: a fallback for older or problematic hardware.
  • Metal: the relevant renderer on macOS, especially Apple Silicon systems.

Set Resolution Scale to native first. On a standard 1080p display, 2× is a reasonable starting point if your GPU has headroom. The available choices include native, 2×, 3×, 4×, and custom scaling.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Higher resolution scaling and anisotropic filtering can introduce glitches in some games. If a title shows broken textures, flickering, or unexpected rendering, return to native resolution, reduce filtering, and test the other supported renderer.

Ryujinx is pre-optimized for normal use. Leave settings not covered by a specific troubleshooting need at their defaults. Keep normal logging enabled; do not enable debug logging unless support staff asks you to.

Why the first launches may stutter

Shader compilation and translation-cache creation can make the first launches slower or less smooth. That does not necessarily mean the emulator or game is permanently broken.

Shader Cache is enabled by default. If a corrupted cache causes a crash while shaders compile:

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Right-click the game in the library.
  2. Choose Cache Management > Purge Shader Cache.
  3. Launch the game again.

You can inspect the cache through Cache Management > Open Shader Cache Directory.

Rank #4
GameSir Nova Lite 2 Wireless PC Controller Hall Effect Sticks
  • Multi-Platform PC Gaming Controller: Working with Switch, PC, Android, and iOS devices via Bluetooth, wired, and wireless dongle connections.
  • Hall Effect Joysticks: Delivering enhanced recentering performance for smoother control and superior anti-drift capability. Plus, with anti-friction rings.
  • 2-Way Trigger Lock: With trigger stops, gamers can toggle between short and long pull positions. Additionally, gamers can activate hair trigger mode by pressing M+LT/RT (triggers must be in the long pull position).
  • 1000Hz Polling Rate: This ensures that your inputs are registered almost instantaneously, minimizing lag and maximizing your performance during competitive play.
  • Mechanical Circular D-pad: Designed for quick reactions and accuracy in every direction, this D-pad elevates your gaming experience with superior responsiveness.

PPTC (Profiled Persistent Translation Cache) is also enabled by default. It does not improve performance immediately: launch the game at least twice and reach the title screen or beyond. Improvements may become available on the third launch. To disable it, open Options > Settings > CPU and clear PPTC (Profiled Persistent Translation Cache).

Install game updates and DLC

Ryujinx can automatically discover updates and DLC through Autoadd DLC/Game Updates in Options > Settings. If it finds multiple updates, it selects the highest version.

For a manual title update:

  1. Right-click the game.
  2. Choose Manage Title Updates.
  3. Click Add and select the update file.
  4. Click Open, select the version, then click Save.

For DLC:

  1. Right-click the game.
  2. Choose Manage DLC.
  3. Click Add, select the DLC, and click Open.
  4. Select the DLC and click Save.

DLC added through the manager is enabled automatically. You do not need to copy every update or DLC file into arbitrary emulator folders.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Install mods and cheats

Mods

For an unzipped mod folder, use Right-click game > Manage Mods > Add, select the folder, and click Save. Mods added through the manager are enabled by default.

For manual content mods, use:

%appdata%Ryujinxmodscontents<game ID>

You can open the correct location with Right-click game > Open Mods Directory. Atmosphère-format mods use:

%appdata%Ryujinxsdcardatmospherecontents<game ID>

The corresponding shortcut is Open Atmosphere Mods Directory.

Cheats

Cheat files are specific to both the game and its version. The documented structure is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Cheat_Namecheats<16-character-build-ID>.txt

Cheats are disabled by default. Enable one through Right-click game > Manage Cheats, check the desired cheat, and click Save.

Best Value
EasySMX X15 Wireless PC & Steam Gaming Controller, Hall Effect, Black
  • Platform Compatibility: This PC controller is designed for Windows PC, Steam, Switch, Android, and iOS. Xbox-style asymmetric stick layout for PC gamers. Three modes cover all your devices. Please check your device compatibility before purchase
  • Three Connection Modes: 2.4G wireless, Bluetooth, wired USB-C. PC gets native XInput/DirectInput. Switch pairs via Bluetooth, no adapter. This gaming PC controller switches devices seamlessly. Stable wireless minimizes random disconnects during gaming
  • Hall Effect Precision: Hall effect joysticks and triggers eliminate stick drift. This gaming controller for PC delivers smooth, responsive input with no dead zones. Built for FPS, racing, and action games. Long-term precision for competitive PC gaming
  • Back Buttons & Battery: Two programmable back buttons map combos and shortcuts. Textured grips with dual vibration. 1000mAh battery delivers up to 20H playtime. RGB can be turned off. A solid PC controller for gaming with custom back buttons
  • ABXY Layout Switch: Press B + Minus + Plus to swap between PC and Switch modes. Features: 1000Hz polling rate, RGB lighting, turbo. Note: designed without mic jack or gyro sensor

Manage profiles and save data

Open Options > Manage User Profiles to create or manage profiles. Save data is tied to the selected profile, so deleting a profile also deletes the saves associated with it.

The default RyuPlayer profile cannot be deleted because it contains the original save data for games. You can rename it and change its image.

Before changing profiles, moving data, or experimenting with mods, back up your Ryujinx data directory at %appdata%Ryujinx.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Portable mode and custom data locations

To keep keys, firmware, saves, shader caches, and configuration beside the executable, create a folder named exactly:

portable

Place it in the same directory as Ryujinx.exe, then launch Ryujinx again.

Portable mode does not automatically migrate existing data. Copy your keys, firmware, saves, and caches from %appdata%Ryujinx into the new portable data directory if you need them there.

You can also specify a custom Windows data directory:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
ryujinx.exe -r d:ryujinxdata

Create the destination folder before launching the command. For reference, the documented macOS command is:

/Applications/Ryujinx.app/Contents/MacOS/Ryujinx -r /path/to/custom/ryujinx/folder

To start games in fullscreen, enable Options > Start Games in Fullscreen Mode or use:

--fullscreen

Common problems and fixes

Problem What to check
Ryujinx will not start Verify the archive hash, extract the full publish folder, update GPU drivers, and install the .NET Desktop Runtime if Windows requests it.
Game list is empty Add the folder containing the game files through Options > Settings; do not select only the individual file.
Missing-key or firmware errors Use keys at least as new as the firmware and confirm that your files are in the active system directory.
Controller is missing Connect it before opening Input settings. Check the Input Device dropdown and use an XInput translator if necessary.
Game crashes during startup Purge the game’s shader cache, then retry. Also test native resolution and another renderer.
Performance is poor on the second launch Reach the title screen at least twice so PPTC can build its cache; improvements may appear on the third launch.
Saves disappeared after enabling portable mode Portable mode uses a new data directory. Copy the original saves and other required files into it.

Official references

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.