Files
libretro/wiki/troubleshooting.md
T
Abdessamad Derraz f44ef8459e docs: state only what the code proves
Each claim in the README and the wiki now matches the code or data it
describes: line citations counted as such (93%), closed-source profiles
named, severity tied to the check mode, installs limited to files the
collection holds, and the demo labelled as a demonstration card.
2026-11-09 08:47:21 +01:00

3.7 KiB

level, order, terms
level order terms
start 40 bios not found, bios missing, firmware missing, bios error, check my bios folder, check bios folder

When a game does not start

Usually a BIOS file is missing or wrong.

1. Check the BIOS folder

The emulator says BIOS not found, BIOS missing or firmware missing? Run the command with --check. It changes nothing.

curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --check

Read the count line:

  0 in place, 108 missing, 1 wrong copy
  • wrong copy: another region or model, or damaged.
  • A number before missing: files are missing.
  • A line under a file, like still zipped, says the fix.
  • 0 missing, 0 wrong copies: go to step 3.

2. Fix the files

Without --check, it adds the missing files the collection holds and replaces wrong ones.

3. Check the folder and the names

  • Right folder? Get the files names it.
  • Exact name? scph5501.bin and SCPH-5501.BIN differ.
  • A bios folder inside the BIOS folder? The installer copies those files up one level.
  • BIOS setting on a subfolder, like system/dc? Point it at the BIOS folder. Emulators add their own, like dc/ for Flycast.
  • A ZIP in parts, like Pack.part1of2.zip? Unzip all parts into one folder.

An arcade game does not start

It needs its BIOS set, like neogeo.zip, and a game set for the same emulator version.

The BIOS is fine, the game still fails

  • Another emulator? Each reads the files listed on its page.
  • A BIOS setting? Some emulators can skip the BIOS. In PCSX ReARMed, set BIOS Selection to Auto.
  • The screen says "Please insert PlayStation CD-ROM"? The BIOS works. The game did not load, so open its .cue or .m3u file, not a .bin.

If the command fails

  • Network error: try again later.
  • The clock reads ...: set the right date.
  • Permission denied: do what the message says.
  • No supported platform detected: name the folder. Not sure? Open RetroArch's Settings > Directory > System/BIOS.
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --platform retroarch --dest ~/.config/retroarch/system

Other messages: When something goes wrong.

Next steps