Game directory setup guide

How to Add Games to Ryujinx: Game Directory Setup and Fixes

Point Ryujinx Canary at a legal local game folder, rescan the library, and isolate path or permission problems when a title does not appear.

Open the Install Guide Check Compatibility

$ choose a stable local folder

$ open the game-directory setting

$ rescan and test one title

$ separate setup from downloads

This is an independent setup guide. It does not host games, ROMs, keys, firmware, updates or DLC.

Main task Add a legal folder
Best first check Rescan the library
If missing Path + permissions
Boundary No ROM downloads

Add a Game Directory in Four Checks

01

Use a stable local folder

Keep your legally obtained game files in a folder you can read and back up. Avoid a temporary archive, a cloud placeholder or a protected system path while testing.

02

Open the directory setting

Launch Ryujinx, open its settings or options area, and find the control labelled Game Directories or an equivalent library-folder field.

03

Add the folder and rescan

Choose the folder that contains the game files, apply the setting, then rescan or restart the library. Test one title before changing graphics or keys.

04

Separate the next diagnosis

If the title appears but will not boot, move to compatibility or crash checks. If nothing appears, verify the path, file visibility and permissions first.

How to Add Games to Ryujinx

The short answer is: place your legally obtained game files in a stable local folder, open Ryujinx settings, add that folder under Game Directories, apply the change, and rescan the library. The exact label can vary between builds or translations, so look for the setting that controls the game library rather than guessing a hidden system path. If the game still does not appear, check the folder level, file visibility and permissions before changing firmware or graphics settings.

Choose a Folder, Not a Download Page

A game directory is a local folder that Ryujinx can read. It is not a release URL, a browser download location or a folder containing only an unopened archive. Keep the emulator package, user data and your own legally obtained game files separate so a path problem is easy to identify.

  • Choose a folder with a short, stable path while troubleshooting.
  • Confirm that the folder contains the files you intend to test and that they are not cloud-only placeholders.
  • Do not point Ryujinx at the emulator program folder unless that is deliberately how you organize your own files.
  • Keep a backup copy before moving a large library or changing storage devices.
Editorial concept illustration of a local folder flowing into an emulator game library
Editorial concept illustration, not an official Ryujinx screenshot: a local folder is added to a game library.

Windows, Linux, macOS and Steam Deck Path Notes

The same principle applies on every platform: use a readable folder, add that folder to the library and test one title. The visible path and permission behavior can differ, so use the table as a diagnostic starting point rather than a promise that every build uses the same menu wording.

Platform or situation Start with Why it matters
Windows A user-owned folder outside protected system locations Permissions, drive letters and cloud placeholders can hide files.
Linux A readable path with correct mount and file permissions A mounted drive or case-sensitive path may not match what you typed.
macOS A folder the app is allowed to read Privacy prompts or external-volume permissions can block library scans.
Steam Deck A stable Desktop Mode or game-storage path Storage mounts and game-mode launch context can change path visibility.
Editorial concept illustration of game folders, platform paths and readable permissions
Editorial concept illustration, not an official UI: the same folder decision can behave differently across platforms and permissions.

If Games Do Not Appear After Adding the Folder

When a game does not show up, avoid changing several variables at once. Confirm that Ryujinx is reading the folder you selected, then rescan or restart the library. The symptom usually points to one of four layers: the wrong folder level, a hidden or incomplete file, a permission or mount issue, or a format that the current build does not recognize.

Symptom First check Next action
The library is completely empty Selected path and read permission Choose the folder again, apply it, then restart Ryujinx.
Some games appear but one does not That file's location and visibility Check that the file is complete, locally available and inside the added folder.
The game appears but crashes Whether the problem is after library detection Use the compatibility and crash guides instead of repeatedly changing the directory.
The path works on one device but not another Mount point, drive letter or access grant Use a platform-specific readable path and add it again on the second device.
Editorial concept illustration of rescanning a missing game library after checking folder permissions
Editorial concept illustration, not an official Ryujinx screenshot: rescan after verifying the folder and access layer.

Keep Game Directory Setup Separate From Downloads

This page explains how to point an emulator at files you are legally entitled to use. It is not a source for games, ROMs, keys, firmware, updates or DLC. Mixing download claims with directory instructions makes it harder to tell whether a missing title is a path problem or an unsafe package problem.

  • Use only game files you are legally entitled to use.
  • Do not download preconfigured libraries or shared archives just to make the list populate.
  • Keep prod.keys and firmware in their own legal setup workflow; they are not a substitute for a game directory.
  • If a page bundles the emulator with games or setup files, treat the source as a separate safety question.

When to Use the Other Ryujinx Guides

The directory task ends when Ryujinx can see the title and you can run a controlled first test. From there, route the next symptom to the page that owns it instead of changing the folder repeatedly.

  • Use the install guide for first launch, user folders, keys and firmware order.
  • Use the game compatibility guide when a listed title boots poorly or has graphics, audio or save symptoms.
  • Use the crash guide when the emulator or a title closes unexpectedly.
  • Use the update or download guides when a build change or package choice is the likely variable.

Official Documentation Checked

The page follows the official documentation boundary for controls and troubleshooting while keeping all game and setup files outside the site.

Ryujinx Game Directory FAQ

How do I add games to Ryujinx?

Put your legally obtained game files in a stable local folder, open Ryujinx settings, add that folder under Game Directories or the equivalent library-folder setting, apply the change and rescan or restart the library.

Should I add a game file or the folder that contains it?

Start with the folder that contains the files you want Ryujinx to scan. Do not point the setting at a browser page or an unopened archive, and do not assume the emulator program folder is the correct library folder.

Why are my games not showing in Ryujinx?

Check the selected folder level, whether the files are fully available locally, whether the operating system allows Ryujinx to read the path, and whether a rescan or restart is needed. If one title appears but will not boot, switch to compatibility troubleshooting.

Can I use the same game directory on Windows, Linux, macOS and Steam Deck?

The setup idea is the same, but paths, mounts and permissions are not. Add a readable path for each device and verify the library in that platform's launch context.

Does this page provide Ryujinx games or ROM downloads?

No. This page only explains how to configure a local game directory for files you are legally entitled to use. It does not host or link to games, ROMs, keys, firmware, updates or DLC.