Files
libretro/wiki/troubleshooting.md
T
Abdessamad Derraz e5cd024e2e fix: settle the round 4 site merge
Root pages nothing produced are swept, so a table moved to a platform page no longer keeps the address its redirect needs. Data tree pages name their readers, board crumbs end on the Arcade page once, fba2012 is headed FB Alpha 2012, test profiles get no page, and the installer glance lists --declared-only and --offline. sitesources.py goes through run_cli.
2026-10-23 20:04:33 +02:00

3.3 KiB

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

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 what to 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? Run the installer: it 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 every part 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 its own 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 setup found: name it and its folder:
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