Files
libretro/wiki/faq.md
T
Abdessamad Derraz 44a60ca96f docs: quote the bootstrap refusal word for word
The FAQ said the installer stops when it does not match "its
fingerprint", and the bootstraps print "does not match its expected":
the page quotes them again, within the page's word ceiling.
2026-11-09 12:11:52 +01:00

4.2 KiB

level, order, terms
level order terms
start 50 ios, iphone, ipad

Common questions

Are BIOS files needed?

  • Yes for PlayStation 2 and Neo Geo.
  • Most emulators for PlayStation 1 and Saturn.
  • Better with it for Dreamcast.
  • Usually not for NES or Super Nintendo.

What is a BIOS?

How to tell which BIOS is needed?

--dry-run lists them, changing nothing.

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

Is every file of a console needed?

No. --core pcsx1 keeps what PCSX reads:

curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --system sony-playstation --core pcsx1

Does the BIOS set the game's language?

It mostly comes from the game. Some follow the console's setting, like Flycast's Language option.

Zip or unzip?

Unzip into the folder the setup's page names. Keep inner ZIPs zipped, like neogeo.zip.

Does a BIOS work on every setup?

Usually. The command installs each setup's own, like neogeo.zip.

An arcade game fails (which MAME version?)

Game sets must match the emulator's version: the list.

Keys, firmware or BIOS?

  • BIOS or firmware: the console's own program, like scph5501.bin.
  • Newer consoles need a system update, like PS3UPDAT.PUP, installed in the emulator.
  • Keys unlock encrypted games, like prod.keys for Switch.

Is the command safe?

  • It stops if the installer does not match its expected fingerprint, and checks each file.
  • It fills the BIOS folder, some save folders and a games cache.
  • It never touches games or save files.
  • It keeps each file it replaces in retrobios-backup, for --restore.

Read them: install.sh, install.ps1, install.py.

Windows or an antivirus blocks the command

Use the setup's ZIP. None? Pick the consoles and download their files.

Why is there no ZIP for a setup?

ZIPs are made for the setups most people download. The command installs each setup's listed files and checks each one. --dry-run shows the list first.

Fill an SD card from a computer?

The interface finds a muOS, Onion, spruceOS, MinUI, KNULLI, ROCKNIX, Lakka or MiSTer card. Else name its setup and BIOS folder. For RetroArch on a Switch, with the card in drive E:, run:

curl -fsSL https://abdess.github.io/retrobios/i \
  | sh -s -- --platform retroarch --dest /path/to/sdcard/retroarch/cores/system

No internet on the device?

Fill it from a computer or point --from-pack at the ZIP: Without a network.

Lost or wiped card?

--from copies BIOS files from an old card or backup: Copy from an old card.

A setup is not in the list

Why is a file missing from the ZIP?

Some come with the emulator. Others are still missing.

A game shows a black screen

Maybe a missing BIOS: When a game does not start.

Can an owned console's BIOS be copied?

Yes: PCSX2 for PlayStation 2, melonDS for DS and DSi.

It depends on the country.

Next steps