Library & ROM folders¶
Home folder and extra folders¶
The library comes from two kinds of folder:
- The home folder, laid out as
Roms/<Name (TAG)>/, one folder per console, such asRoms/Game Boy Advance (GBA)/. The app created it and writes only inside it. - Extra folders, any number of them, scanned in place and never written to.
The app matches the files in an extra folder to a console by the folder's name or the file's extension. Anything left over lands in Unassigned games until you pick its console.
The app never deletes a game. It moves games only inside the home folder,
while Move them into
More detail
During first-run setup, the home
folder's page offers Move them into Roms/. An extra folder's page only says
what it found.
Files in an extra folder are matched to a console:
- by a
(TAG)or an alias in the folder name (a short alias such asGBAmay be followed only by roms, games or isos, singular or plural), - then by an extension only one console uses (a zip by its first entry, a 7z only by its folder).
The console you pick for an Unassigned game is saved in a systems.txt
(<file><TAB><TAG>). For extra folders this file lives in the home folder
under Roms/.sources/, so the extra folder itself is never changed.
When a console's games were split over two folders and are merged into one, their play time moves with them.
Settings → Library¶
Tools → Settings → Library shows what the library holds and every folder it reads, in one list.

| Row | What it does |
|---|---|
| The counts, such as 212 games · 20 consoles | With Last scan: and its date under it. Its Rescan button scans every folder again; a notice then says how many games the library has. |
| Home folder | Shows the home folder's path. A picks a different one, then offers to copy your saves to it: Copy or Keep separate. Nothing is deleted from the old folder. Without All files access, A opens the access page instead. |
| ROM Folder: and its name | One row per extra folder, with its path or its state under it. A offers to remove it. |
| + Add ROM folder | Pick another extra folder to scan, such as one on an SD card. |
| All files access | Android 11 and later. A switch: a tap, or A, opens Android's page for the app. See All files access. |
| Microphone access | On phones with a microphone. On or Off: a tap, or A, asks for it, or opens Android's page for the app when Android won't ask again. See Microphone access. |
| Saves | Save formats, and export or import your saves. See Saves. |
| Import BIOS | Copy BIOS files in from a folder, files, a zip or RetroArch. See Import BIOS. |
| Android games | How many apps are in the Android console. Opens the picker. See Launcher Mode & Android Games. |
| Unassigned games | Only when some games have no console. Shows how many, and opens their list. See Unassigned games. |
| Hidden games | Only when some games are hidden. Shows how many, and opens their list: A on a game shows it again. |
Removing an extra folder only stops scanning it: the Remove folder dialog asks Stop scanning this folder? Its ROMs stay where they are. Choose Remove. Nothing in the folder is deleted.
More detail: folder states
An extra folder's row reads its path while it was found at the last scan. Otherwise it shows its state, in the warning colour:
| State | Meaning |
|---|---|
| Not available | Its storage was missing, such as an SD card taken out. |
| Not ready yet | Its storage is in, but Android didn't list it in time. Use Rescan in a moment. |
| All files access off | The folder was picked with All files access, which is now off. |
While the home folder's storage is missing, its row reads Not available.
All files access¶
With All files access on, the app reads your folders directly, which is faster on large libraries, and uses its own folder picker.
- Folders you picked earlier switch over by themselves. Nothing is lost.
- If you turn the access off, your folders are kept, and the app switches to
its own
Android/media/com.nxredux.mobile/folder. The All files access row then says so under its name, in the warning colour. Turn it back on and your home folder and games come back, with no rescan needed. Saves made in the meantime stay inAndroid/media; see Getting Started.
More detail
- Without it, the app reads through Android's storage picker. With it, every folder or file pick uses the app's own picker.
- A home folder or extra folder picked through Android's picker, on the phone's storage or an SD card, switches over with its games, hidden games and names as they are.
- While the access is off and something needs it, the row's line says what: Off: your home folder can't be read, so and the folder used instead, or Off: some ROM folders can't be read. The app no longer says it with a notice each time it starts.
Microphone access¶
Nintendo DS and 3DS games that listen for a blow or a shout hear your phone's microphone while their Mic is on and this access is allowed. See Microphone.
The app asks for it the first time you turn a game's Mic on, never at install or start. Turned off, or never allowed, the games hear a made-up blow instead, so their mic puzzles can still be passed.
More detail
- The row is hidden on phones without a microphone and on Android TV.
- Once you have said no in Android's prompt and it won't ask again, the row opens Android's page for the app instead, where you can turn the Microphone permission on.
- What the games hear stays on your phone and is never recorded.
The folder picker¶
With All files access, every folder or file pick (home folder, extra folder, import, export) uses the app's own picker, a list like the rest of the app.

- Open folders until you reach the one you want, then choose the button at the bottom that names it, such as Use NXRedux (or Save in Exports for an export). A storage's root goes by its name: Use SD card. New folder sits beside it.
ASelect opens a folder, or picks the row.BBack goes up a level, and at the storage list cancels.Left/Rightjump from the folders to the actions at the bottom, move between the two actions, and past either end go back to the folder you left. The hint names where they go: Actions or Folders.UpandDowntake the two actions as one line.Xor New folder asks for a name and opens the new folder. The name is typed on the NX keyboard.
More detail
- It starts at your storage, Internal storage and any SD card, or next to your home folder. The title shows the folder's path, such as Internal storage/NXRedux.
- The picker opens on the first entry: .. for the folder above,
then the folders, A–Z, then the files, dimmed: they show what a folder
holds, but can't be picked. When importing a zip, the
.zipfiles are the ones you pick. Hidden (dot) folders and files are not shown. - Use
(or Save in ) and New folder sit side by side at the bottom, as a pop-up's buttons: the first in your accent, New folder outlined, and a ring where the controller is. Where there is no Use button, New folder takes the accent. A folder name too long for the button ends in "…". - The button always takes the folder you are in, not the one highlighted in the list.
- When picking the home folder, a line under the title says what the folder is: Empty folder, NX Redux folder, or Has other files: games found in it will be sorted into Roms. An SD card's root can be the home folder; the phone's storage root has no Use button.
- An export over a file of the same name asks Replace
? first.
Import BIOS¶
Tools → Settings → Library → Import BIOS copies BIOS files into your
home folder's Bios/<CONSOLE>/ folders, each under the name its emulator
reads. You can still put them in Bios/ by hand; see
BIOS files.
| Row | Copies from |
|---|---|
| From a folder | A folder you pick, and the folders inside it. |
| From files | The files you pick. |
| From a zip file | A zip you pick. |
| From RetroArch | RetroArch's system folder. With All files access, every one found is read; without it, pick RetroArch's folder (the one with system inside). |
Each file is recognised however it is named:
- By checksum first:
[BIOS] Sega CD (USA).bingoes toBios/SEGACD/bios_CD_U.bin, andSCPH-39001.bintoBios/PS2/. - Then by name and size: a known name at a size that file can have is copied too, marked not verified. A known name at a size it can't have is skipped.
- A file several consoles use is copied into each of their folders.
Nothing is fetched from the internet, and the files you pick are never changed. A file already in place with the same bytes is left alone, and a not verified file never replaces a BIOS you already have.

The results page sums it up, such as Imported 3 BIOS, 1 already there, 1
kept, with a line per file (verified, not verified, renamed
from …, already there or kept yours) and the files skipped, with
why. A or B on Done goes back to Library.
More detail
- Optional boot files (the Game Boy, Super Game Boy and Master System / Game Gear boot ROMs, the Genesis TMSS) are imported too, noted changes boot: the game then starts with the console's boot screen.
- For PS2, any 4 MB console dump is recognised, under its own name. The same PS2 BIOS under another name counts as already there.
- Arcade BIOS sets (
neogeo.zip,naomi.zipand others) are matched by name at any size, since their size changes between romset versions. - Not imported: game data (Doom IWADs, Stella samples), Dolphin's
GameCube IPL, and an emulator's own data files (Dreamcast's
dc_nvmem.bin, PS2's memory card files). - Import BIOS can't run while Device Sync is running, or without a home folder. A pick with no BIOS in it ends with No BIOS found.
- A BIOS you later delete or rename in
Bios/stops being used: the app removes its own copy at the next launch.
Unassigned games¶
Games the app couldn't match to a console are listed under Tools → Settings → Library → Unassigned games. The row shows only while there are some. They don't show on the main menu.

An Unassigned game can't start until it has a console. To give it one:
- Highlight the game and press
MENU, or long-press it. - Choose Console. It lists the consoles that can run the file.
- Pick the console. The game moves to that console's list, using the console's default emulator.
More detail
- Console lists every console whose emulator can run the file's type. A zip or 7z file is unpacked at launch, so every console is offered for it.
- The context menu for an Unassigned game offers only Hide Game, Rename Rom and Console.
Disc games in their own folder¶
A game with several files, such as a Dreamcast .gdi with its tracks, can
sit in its own subfolder of the console's folder. The subfolder is listed as
one game when it holds a .m3u, .cue or .gdi named after it:
Roms/Dreamcast (DC)/
└── Soulcalibur/
├── Soulcalibur.gdi
├── track01.bin
├── track02.raw
└── track03.bin
Name the sheet after its folder
A sheet named anything else, such as a TOSEC disc.gdi, doesn't make the
folder a game. Rename the sheet after its folder. See
Dreamcast.
More detail
- Saves, states and the VMU are keyed by the sheet's name, so games whose sheets share a name would share them.
- A sheet saved in an older Windows text encoding, or with a byte-order mark, is read too. So is one whose track names differ from the files only in letter case.
Android games as a console¶
Android games you add show as an Android console on the Consoles tab. Add them on first setup, or later in Tools → Settings → Library → Android games. See Launcher Mode & Android Games.
Rescanning¶
After adding or removing games outside the app, use Rescan in Tools → Settings → Library.
If you take out an SD card, the games from extra folders on it are left out until the card is back. Nothing is lost.
More detail
- The app keeps the scanned library in an index, so it starts without walking your folders.
- An extra folder that was deleted, or whose access was revoked, is dropped with a notice.
- A home folder that is lost returns you to the folder picker.
- A home on a removed SD card keeps the last index on screen, and the Home folder row reads Not available.
Game names¶
Bracketed region and version text is dropped from names, as on the handheld: "Tetris (World) (Rev 1)" shows as "Tetris". If two games would end up with the same name, both show their file names.
Custom display names (map.txt)¶
To rename games without touching the files, drop a map.txt inside the
system folder. Each line maps a filename to a display name, separated
by a single tab:
Roms/Game Boy Advance (GBA)/map.txt:
Advance Wars 2 - Black Hole Rising (USA).gba Advance Wars 2
Legend of Zelda, The - The Minish Cap (USA).gba Zelda: Minish Cap
The list re-sorts by the new display names. Since the files themselves are
untouched, save files, states and box art all stay matched. An alias starting
with a dot (e.g. Track01.bin .hidden) hides the entry from the list
entirely.
Rename Rom in the game-list context menu writes these aliases for you.
More detail
For games in an extra folder, the alias goes into a map.txt under
Roms/.sources/ in the home folder. It overrides the extra folder's own
map.txt.
Collections¶
Use Add to Collection in the game-list context menu.
Under the hood each collection is a plain text file at
Collections/<Name>.txt, with one path per line, relative to the top of your
library (the SD card on a handheld). You can also build them on a computer:
Collections/RPG Nights.txt:
/Roms/Game Boy Advance (GBA)/Golden Sun.gba
/Roms/Sony PlayStation (PS)/Final Fantasy VII/Final Fantasy VII.m3u
Entries whose file is missing are silently skipped.
Saves¶
Battery saves, save states and per-game settings are kept in your home
folder, laid out as on the handheld's card: Saves/<TAG>/ for battery saves
and .userdata/ for the rest. Without All files access, they are in
Android/media/com.nxredux.mobile/. See
Getting Started.
Tools → Settings → Library → Saves sets how saves are named, and copies them out and back in:
| Row | Values | Default | What it does |
|---|---|---|---|
| Save format | MinUI, Retroarch (compressed), Retroarch (uncompressed), Generic | Retroarch (uncompressed) | How battery saves in Saves/<TAG>/ are named. The default works with RetroArch on other devices. |
| Save state format | MinUI, Retroarch-ish or Retroarch, each compressed or uncompressed | Retroarch (uncompressed) | How save states are named. |
| Use extracted file name | On, Off | Off | For zipped games, saves and states take the unzipped file's name instead of the zip's. This changes which saves a game finds. |
| Export saves | See below. | ||
| Import saves | See Import saves. |
A line under the page's title says where your saves are kept.
Tools → Settings → Library → Saves → Export saves writes one zip of your saves, states and slot pictures, which unzips onto a handheld card as it is.
Uninstalling without a home folder
In your own home folder, saves survive an uninstall. In
Android/media/com.nxredux.mobile/ (All files access off), Android removes
them with the app, so export them or copy the folder first.
Nothing in the app deletes a ROM.
Import saves¶
Tools → Settings → Library → Saves → Import saves copies saves into the app. First-run setup offers the same choices on its Bring your saves step.
| Option | Reads |
|---|---|
| From a folder | Any folder you pick. |
| From a zip file | Any zip you pick, such as one from Export saves. |
| From RetroArch | RetroArch's own saves/ and states/ folders. |
- Copy only. The files you import from are never moved, changed or deleted.
- Any layout. A folder or zip can follow the handheld's card layout, or
hold all your save files in one place. Saves are matched to your games by
name, so
Pokemon Emerald.srmgoes withPokemon Emerald.gba. .srmand.savboth work, and so do RetroArch's compressed saves. Each one is saved in your Save format.- Newer wins. When the app already has a save for that game, the newer
one is kept. The older copy is kept as a
.bak. - Save states never overwrite. An imported state goes into its own slot when it's free, otherwise into the first free slot.
When the import is done, a results page lists what came in, what was already there, and each file it skipped, with the reason.
| Reason | What it means |
|---|---|
| no matching game | No game in your library has that name. |
| matches two consoles | Games on two consoles have that name, and the folder doesn't say which. |
| phone copy is newer | The app's save for that game is newer. |
| no free slot | All 8 state slots for that game are taken. |
| can't tell the core | A save state whose emulator can't be told from where it was. |
| could not be read | The file couldn't be read, or is damaged. |
Imported save states may not load
A save state loads only in the emulator that made it, with the same BIOS setting. A state from RetroArch's mGBA, for example, needs mGBA, and Use BIOS File if Found set the way RetroArch had it. If a state won't load, use the battery save: it works in any emulator for that console.
More detail
- From RetroArch reads
Android/media/com.retroarch/RetroArch/, and RetroArch Plus and 32-bit's folders when they're there. Without All files access it asks you to pick RetroArch's folder. - RetroArch's folder names, such as
saves/mGBA/, tell the import which console and emulator a file is for. A save in one folder for all consoles is matched by name alone. - A state is only taken when its emulator can be told: from RetroArch's folder for that emulator, from the handheld's card layout, or when its console has a single emulator. Loose states in a folder or zip of your own are skipped.
- A game in your home folder and an extra folder counts once.
- Files that aren't saves or states, such as ROMs and configs, are only counted, as other files ignored.
- Running the same import again shows the files as already here.
- A folder or zip in the handheld's card layout is copied as it is laid
out, saves for games you haven't added yet included. A save from
Saves/GPGX/goes with the console whose games hold its game. With none or several, it goes to Sega Genesis.
More detail: where saves are kept
- Saves are kept in the handheld's card layout. The home folder holds
Roms/,Bios/,Collections/,Cheats/,Saves/and.userdata/. It can also holdShaders/,Textures/,Logs/and, while Kids Mode is on, akids-mode.flagfile: see Choose a home folder. - Saves, states and settings made in
Android/mediawhile All files access was off stay there. They are not merged with the saves in your home folder. - Saves and BIOS are kept per console, in
Saves/<TAG>/andBios/<TAG>/with the console's tag, such asGBAfor both gpSP and mGBA. BIOS files are read fromBios/<TAG>/before each launch. - Pinned games, recents and play time are kept in the home folder's
.userdata/shared/. Hidden games are kept in.userdata/android/hidden.txt, so they stay on this phone and don't sync. Hidden games can be shown again from Tools → Settings → Library → Hidden games. - Cores keep the battery save in memory while you play. The file in
Saves/<TAG>/is updated after each save write and when you quit. Save states are kept per emulator, in.userdata/shared/<TAG>-<core>/. - An export writes each console's saves under its default emulator's
handheld tag, such as
Saves/GPGX/for a Sega console on Genesis Plus GX. When two consoles' saves would meet under one name there, both keep their console folders (Saves/MD/,Saves/SMS/), so neither is dropped.
Art and game info¶
Fetched art is kept next to the games, in a .media/ folder inside each
console's folder, one folder per kind of picture. A game's genre, year,
publisher and synopsis are kept there too, in .media/info/. See
Artwork and Game info.
.media is a hidden folder, and the app writes it only in the home folder.
Art for games in an extra folder goes under Roms/.sources/ in the home
folder.
Unpacked games cache¶
Zip and 7z games are unpacked into the app's cache on their first launch. The app trims this cache on its own. Clearing the app's cache in Android's settings is safe too: games are unpacked again when needed.
More detail
- Some cores get a copy of the game file in the cache too.
- The app trims the cache when it starts and after Download all game data in RetroAchievements.
- Anything not used (played or checked for achievements) in 30 days goes first. Then the least recently used goes, until the cache holds at most 256 MiB.
- The game that is running is never removed. A file bigger than the cap on its own stays while its game runs, and goes at the next trim.