Skip to content

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 as Roms/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 /Roms is on during setup. It never moves games out of an extra folder.

More detail

During first-run setup, the home folder's page offers Move them into /Roms (on by default) when some of its games are outside Roms/. An extra folder's page only says what it found.

Files in an extra folder are matched to a console:

  1. by a (TAG) or an alias in the folder name (a short alias such as GBA may be followed only by roms, games or isos, singular or plural),
  2. 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.

Settings, with Library open beside the sections: the counts with Rescan, Home folder, + Add ROM folder (selected), All files access, Microphone access, Saves and Android games

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 in Android/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.

The app's folder picker at the NovaBlack SD card's root: .. and the folders in one column with Alarms selected, Use NovaBlack and New folder at the bottom, and the hints Actions, New folder, Back and Open

  • 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.
  • A Select opens a folder, or picks the row. B Back goes up a level, and at the storage list cancels.
  • Left / Right jump 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. Up and Down take the two actions as one line.
  • X or 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 .zip files 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).bin goes to Bios/SEGACD/bios_CD_U.bin, and SCPH-39001.bin to Bios/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 Import BIOS results page: Imported 22 BIOS, then a line per file such as Atari 5200: 5200.rom (verified), Dreamcast: awbios.zip (not verified) and Game Boy: gb_bios.bin (verified, changes boot), and Done

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.zip and 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.

The Unassigned games list, holding one game

An Unassigned game can't start until it has a console. To give it one:

  1. Highlight the game and press MENU, or long-press it.
  2. Choose Console. It lists the consoles that can run the file.
  3. 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.srm goes with Pokemon Emerald.gba.
  • .srm and .sav both 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 hold Shaders/, Textures/, Logs/ and, while Kids Mode is on, a kids-mode.flag file: see Choose a home folder.
  • Saves, states and settings made in Android/media while 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>/ and Bios/<TAG>/ with the console's tag, such as GBA for both gpSP and mGBA. BIOS files are read from Bios/<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.