Ryujinx Setup Guide for Windows, macOS, and Linux

Before setting up Ryujinx, ensure you have the following:

• Ryujinx for Linux: Download the Linux version from the official Ryujinx website.
• Nintendo Switch Firmware: Download the firmware from a trusted source like darstoney.net (via archive.org or Mega). We do not condone piracy; ensure you own a Nintendo Switch.
• prod.keys File: Obtain your prod.keys file legally (e.g., by dumping it from your own Nintendo Switch or searching online). This is required to run games and firmware.
• A Nintendo Switch Game: Use a legally ripped game from your Nintendo Switch (e.g., New Super Mario Bros. U Deluxe).

Important: This guide is for educational purposes only. We recommend owning a Nintendo Switch and legally dumped games to ensure compliance.

Follow these steps to install Ryujinx on your Linux system:

1. Extract the downloaded Ryujinx package to your preferred location (e.g., Downloads folder).

   You don’t need to extract the firmware ZIP file; Ryujinx will handle it.

2. Open a terminal and navigate to the extracted Ryujinx folder (e.g., cd ~/Downloads/ryujinx/publish).

   Launch Ryujinx by running the ryujinx executable: Drag the file into the terminal and press Enter, or run ./ryujinx.

   You may see a "keys not found" error—this is normal and will be fixed in the next step.

3. Install the prod.keys file: In Ryujinx, click File > Open Ryujinx Folder, navigate to the system subfolder, and paste your prod.keys file here.

4. Close and reopen Ryujinx using the same terminal command.

   The "keys not found" error should no longer appear.

5. Install the firmware: In Ryujinx, click Tools > Install Firmware > Install from XCI/ZIP.

   Select your downloaded firmware ZIP file and confirm the installation.

   The process is quick; if it takes too long, restart Ryujinx and retry.

Configure Ryujinx for optimal performance on Linux:

1. Add game directories: Go to Options > Settings > Game Directories, click Add, and select a folder for your games.

   Click Apply and Save to load games. You can add multiple directories or open individual game files via File > Open Application from File.

2. Set up controls: In Settings > Input, configure up to 8 controllers (e.g., keyboard, Joy-Con, Pro Controller).

   Change button mappings as needed, select a controller type (e.g., Pro Controller), and save profiles for different games or players.

3. Set system region and time: In Settings > System, set your region (e.g., Europe) and language (e.g., British English).

   Adjust the time zone if it doesn’t detect automatically—some games like Animal Crossing require this.

4. Adjust graphics settings: In Settings > Graphics, enable shader caches and set anisotropic filtering to Auto to fix texture issues at obscure angles.

   Keep resolution scale at Native unless your system can handle higher (e.g., 4x). Use a 16:9 aspect ratio to avoid game issues.

Now that Ryujinx is set up, start playing your games:

1. Double-click a game in the Ryujinx library (e.g., New Super Mario Bros. U Deluxe) to launch it.

   Loading time depends on your system’s performance and the game.

2. Toggle between handheld and docked modes: In Ryujinx, switch modes to resolve issues like black screens or missing sound (some games work better in handheld mode).

   You can also toggle full-screen mode via Options > Start Games in Full Screen.

3. Check the compatibility list: Visit the Ryujinx compatibility list to ensure optimal settings for your game (e.g., minimum system version, mode preferences).

For additional support or to ask questions, join our community or the official Ryujinx Discord.