Repository navigation
Switch Updates and DLC
Activity → Switch Updates & DLC shows which Switch games on your shelves are behind on updates and which known DLC you don't have. The report itself is read-only: it never imports, extracts, moves, deletes or downloads files.
Files in your Switch and Switch 2 platform folders ending in .nsp, .nsz, .xci, .xcz or .nup, named with exactly one bracketed 16-digit title ID, for example:
Super Game [0100ABCD12340000][v0].nsp
Super Game Update [0100ABCD12340800][v196608].nsp
Super Game Extra Pack [0100ABCD12341001].nsp
[v…] gives the version. File contents are not checked.
Loose files and per-game folders are grouped into one row per game. ROMarr compares the highest installed version with TitleDB's version history, and lists known DLC that isn't present.
- Current, Outdated or Missing update; Unknown when TitleDB doesn't know the game or the version tag is missing.
- The DLC list shows known regional catalogue entries. It is not a guaranteed complete list. Set
TITLED_NAMES=1for the larger regional catalogue, which improves names and coverage. - Switch 2 games don't borrow Switch 1 version histories.
- Ignore hides one DLC from your gaps; Resume tracking brings it back. The underlying facts don't change.
- The sidebar badge counts games with gaps.
- Opening the page scans on demand within a 3-second budget, a 100,000-entry limit and a depth limit. Links, hidden folders, quarantine and media folders are skipped.
- If a limit is hit or a folder changes mid-scan, the report says it's incomplete.
- Refresh rescans; otherwise results are reused for up to 30 minutes.
- An empty shelf never triggers a metadata download.
When ROMarr imports an update or DLC and the game already has its own folder, the file goes inside it: updates to <game>/update/, DLC to <game>/dlc/. RomM then shows them as that game's extra content instead of separate games. The import preview shows where each file will go.
It only does this when the file name has exactly one bracketed title ID and exactly one game folder holds the matching base game. Otherwise the file keeps its normal place. ROMarr never follows a link to reach a game folder, and files already in your library are never moved.
Turn it off under Settings → Media Management → File Switch updates and DLC inside their game's folder.
Under Settings → Profiles (globally or per console):
- Video standard: prefer NTSC or PAL. Explicit labels and bracketed region tags count; unknown or mixed regions stay neutral. Strict refuses releases tagged for the other standard.
-
Preferred formats: an ordered list of extensions per console, e.g.
chd, cue, binfor PlayStation. Only the final extension counts; a selected file inside a torrent takes precedence over the release name.
Both show up as scoring reasons and never bypass normal checks.
GET /api/v1/switch/updates (refresh=1 rescans), GET /api/v1/switch/gaps (cached summary only), POST /api/v1/switch/ignore with tid and boolean ignored.
Full guide: SWITCH-INVENTORY.md.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.