[UWP/Xbox] Manual scan cannot read external USB drives - playlists always empty
Nobody has claimed this yet.
- Dominant language
- C
- Stars
- 14.1k
- Forks
- 2.2k
- Avg merge
- 7h 35m
- Merged PRs (30d)
- 51
Description
Is there an existing issue for this?
- This is a bug in RetroArch frontend
- I have searched the existing issues
Description
Platform: Xbox Series X, RetroArch UWP build (latest)
Bug description
The manual/automatic content scanner always finds 0 games on an external USB drive, across all systems (PS2, PS1, SFC/SNES, FC/NES, DC, PSP, ...).
Expected behavior
Scanning a folder on external USB storage should create a playlist with the games found.
Actual behavior
Scan completes but reports 0 items. No playlist is created.
Facts that rule out config mistakes
- Load Content > Browse Files CAN browse and launch games from the same USB drive (so the files and cores are fine)
- The playlists folder itself (RetroArch\playlists) is read from the USB drive without any problem
- File extension filter, system name and core are all set correctly
Suspected root cause
UWP sandbox does not grant broadFileSystemAccess, so directory enumeration on external storage fails, while direct file reads (Browse Files) work.
Workaround (confirmed working)
Generate .lpl files on a PC and copy them into the playlists folder - playlists appear and games launch normally.
Related reports
- #11108 (closed, same issue)
- #10527 (open)
Request
Please enable external USB storage enumeration in the UWP build, or document this as a known limitation so users stop hitting it.
Expected behavior
Scanning a folder on external USB storage should create a playlist with the games found.
Steps to reproduce the bug
- Put game ROMs/ISOs on an external USB drive connected to Xbox.
- Open RetroArch UWP on Xbox.
- Go to Import Content > Manual Scan.
- Select the external USB folder, set system name and core correctly, start scan.
- Scan completes with 0 items; no playlist is created.
Version/Commit
1.20.0
Bisect Results
No response
Present in the nightly version
I don't know
Platform & operating system
Xbox Series X (UWP)
Affected Cores
All cores (issue is in the content scanner, not a specific core)
Environment information
Xbox Series X, external USB 3.0 drive
Relevant log output
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Import Content > Manual Scan path in the UWP build and reproduce the scan against an external USB folder on Xbox. Compare its storage access with Load Content > Browse Files, then verify whether the scanner can enumerate external files. Done means a scan creates a playlist with the discovered games, or the limitation is documented if access cannot be enabled.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- c
- Domain
- frontend, operating-systems
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100