Files
libretro/wiki/troubleshooting.md
T
Abdessamad Derraz 75a6356959 feat: say network failures in plain words
Offline, the run printed "[Errno -2] Name or service not known". The
common failures now read as words, the raw text kept under --verbose.
A refused certificate under a clock set before the installer was written
is reported as reason clock, with the date it reads, and no trusted
certificate list on the machine as reason no_ca, naming SSL_CERT_FILE.
Neither is retried, and verification is never turned off.
2026-10-23 14:14:08 +02:00

2.8 KiB

level, order
level order
start 40

When a game does not start

Most often a BIOS file is missing or wrong.

1. Check my BIOS folder

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, model, or damaged. Batocera says UNTESTED.
  • 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

Run it again without --check. It adds missing files and replaces wrong ones.

3. Check the folder and the names

  • Right folder? Get your files names the one your setup reads.
  • Exact name? scph5501.bin and SCPH-5501.BIN differ. On Linux, capitals count too.
  • A bios folder inside your BIOS folder? Move its files up one level.
  • Unzipped by hand on Linux? Run the command once. It adds names that differ by capitals only.
  • 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.

  • Keep neogeo.zip zipped.
  • A game set for another MAME version often fails. Details: the version of each emulator.
  • Run the command once. It installs the BIOS sets your emulators read.

The BIOS is fine, the game still fails

  • Another emulator? Each one reads its own files. Its page lists them.
  • A BIOS setting? Some emulators can skip the BIOS. In PCSX ReARMed, set BIOS Selection to Auto.
  • A disc game in several files? Open its .cue or .m3u file, not a .bin.

If the command fails

  • Network error: try again once github.com opens.
  • The clock reads ...: the date is wrong. Let it sync over Wi-Fi, or set it, then run again.
  • Permission denied: do what the message says. It names what to run.
  • 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