Skip to content

Troubleshooting

Pictures and bezels

Problem Cause Fix
A game shows no thumbnail Its picture is not named exactly like its ROM (revision, region, a character RetroArch replaces with _) Rename the picture to the ROM's name (see Add a game)
A console shows no thumbnails on the phone or the tablet, although its files are there A folder copy that RetroArch does not read (seen with folders copied by a script) Delete the console's folder in thumbnails\ with My Files, copy the PC folder again, then quit and reopen RetroArch
A game shows the _Default bezel It has no bezel of its own, or its bezel is not named like its thumbnails Add or rename its bezel (see Add a game)
Black bands on the left and right of an N64 game, inside the bezel The game draws a black edge itself, made for old TVs (they hid the edges of the picture). On the N64, each game chooses how much of the picture it fills, so the edge changes from game to game and one value does not fit every game Core Options → GLideN64 → Overscan On, then raise Overscan Offset (Left) and (Right) together (8 in our settings, default 0) until the bands are gone, then Manage Core Options → Save Game Options (see Bezels)

Settings and options

Problem Cause Fix
A setting changed in the menus is lost RetroArch was closed another way than Quit RetroArch, or a game was running (it may load its own settings) Change it with no game running, then Main Menu → Quit RetroArch or Configuration File → Save Current Configuration
An option meant for one game or one ROM folder changed every game It was changed before the game or the folder had its own options file: RetroArch wrote it into the core's file Save the game's or the folder's file first (Save Game Options, Save Content Directory Options), then set the core's option back with Save Core Options
An option changed for every game does not reach some games Those games have their own options file, a full copy of the core's options Change it in their files too (the PlayStation multitap games, see Multiplayer)
The saves end up next to the ROMs Write Saves to Content Directory is on Saving → Write Saves / Save States to Content Directory: Off (see Settings)

Controls

Problem Cause Fix
R2 turbo works in one game, not in the next one (or a game gets another's turbo) A remap without its turbo lines: RetroArch keeps the previous game's turbo for the session Every remap sets the turbo and the stick, even with their default value (see Remaps). How to use the turbo: In game
The shortcuts (Select + ...) do nothing on a controller Only the controller on port 1 can use them Use the player 1 controller (see In game)
An 8BitDo connects to the wrong device It was switched on in the other mode D-input (B + Start) for the PC, the phone and the tablet; X-input (X + Start) for the Raspberry Pi
In DOOM, Select + L or R opens the map Select is also DOOM's map button Save and load with L and R alone (see Game notes)

Playlists

Problem Cause Fix
A game is missing from a playlist, or a new game does not show The playlist was not made again after the ROM list changed Make the playlists again with the collection's scripts, then copy them (Refresh Playlist in RetroArch does not work for these playlists)

Phone and tablet over USB

Problem Cause Fix
A file copied from the device is cut short, or the PC still shows its old size or date Windows keeps showing the old state of a device folder after the device changed it (a setting saved by RetroArch) Unplug and replug the cable, then copy again
The PC does not see the device The cable is in charging mode, or the device is locked USB file transfer mode, the device unlocked

Cloud sync (phone and tablet)

Problem Cause Fix
"Finished with failures" Several files are sent at once and all but one fail Run the sync again: one more file goes each time
"Conflict" on a save A game was started before its save was downloaded: RetroArch wrote a blank save Quit RetroArch, delete or rename the blank local save, then sync
A save from the PC is not on the device Saves copied into Google Drive by hand are not read Copy the .srm into the device's saves\<ROM folder>\ (RetroArch closed), then sync

Warning

Always sync before playing on the other device.

Logs

To see what RetroArch does: Settings → Logging → Log to File On and Logging Verbosity On. They start at the next launch.

Device Log folder
PC C:\RetroArch-Win64\logs\
Phone, tablet Android/media/com.retroarch.aarch64/RetroArch/logs/