Files
libretro/wiki/troubleshooting.md
T

3.8 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 my BIOS folder

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

curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --check

Read the count line:

  1/109 present (0 verified, 1 wrong hash)
  • wrong hash: another region or model, or damaged.
  • Fewer present than the total: files are missing.
  • A line under a file, like still zipped, says the fix.
  • 0 wrong hash, all present: go to step 3.

2. Fix the files

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

3. Check the folder and the names

  • Right folder? Get your files names it.
  • Exact name? scph5501.bin and SCPH-5501.BIN differ.
  • A bios folder inside your 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: 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://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --platform retroarch --dest ~/.config/retroarch/system

Other messages: When something goes wrong.

Next steps