Files
libretro/wiki/faq.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

4.4 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. Some start games without it, with a built-in replacement.
  • Better with it for Dreamcast. Some games need it.
  • Usually not for NES or Super Nintendo.

What is a BIOS?

How to tell which BIOS is needed?

--dry-run lists them and changes 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?

Rarely. It 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 every file the collection holds for each setup 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 the setup and its 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 not in the collection yet: what is still missing names each one.

A game shows a black screen

Often 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