Files
libretro/wiki/first-install.md
T
Abdessamad Derraz b535262637 docs: show the --dest forms and the all-good line
The step for another folder now gives the command with --dest for each
system, the PowerShell one in its script block form. The check line that
means all good is shown whole, since an empty folder also reads 0 hash
mismatches. The port archive is said to come with releases cut after the
port, which v2026.10.10, the latest, predates.
2026-10-23 14:16:40 +02:00

4.3 KiB

level, order
level order
start 30

First install, step by step

From an empty BIOS folder to games that start.

You need: internet and some free space. The installer says how much.

1. Open a terminal and paste

A terminal is a window where you type commands. Paste the line for your system, then press Enter.

Open the Start menu. Type PowerShell and open it.

irm https://raw.githubusercontent.com/Abdess/retrobios/main/install.ps1 | iex

Open Terminal. It is in Applications, then Utilities.

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

Open a terminal.

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

Switch to Desktop Mode and open Konsole.

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

Install Termux, a terminal app. Run these three lines in it.

pkg install python
termux-setup-storage
curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh

On Batocera, Recalbox and similar setups, see Get your files.

2. Check the folder it found

It shows your setup and its BIOS folder:

  Found <your setup> at <its folder>
  • Right folder? Go on.
  • Wrong folder? Press Ctrl+C. Run the command again with your folder after --dest:
curl -fsSL https://raw.githubusercontent.com/Abdess/retrobios/main/install.sh | sh -s -- --dest ~/path/to/bios

3. Choose what to install

  Enter) install everything
  i) only what the installed cores read
  c) choose systems, cores and regions
  q) quit

Enter installs everything. c lets you pick consoles.

4. Wait

You can stop with Ctrl+C at any time. Run the command again to carry on.

5. Read the last line

  • Done. N files installed, M already up to date. All files are in place.
  • Finished with errors. Some files failed. Run the same command again. It retries only those.
  • Nothing was installed. The lines above it say why. See If it stops.

What the command does

Check it later

Add --check to the same command. It changes nothing.

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

All good when every file is present and none is wrong:

  109/109 present (109 verified, 0 wrong hash)

An empty folder also shows 0 wrong hash, with 0/109 present.

Undo

It keeps every file it replaces in a retrobios-backup folder, next to your BIOS folder. The end of the run prints the line that puts them back.

If it stops

No supported platform detected.

At a terminal, a menu follows. Pick your setup by its number, then type its BIOS folder, or press Enter for the usual one. A folder pasted with quotes around it is fine.

With --no-input, or without a terminal, it stops and prints the command to use.

Error: Python 3.8 or newer is required.

The message shows the command that installs Python. Run it, then run the installer again.

A RetroPie 4.8 image has Python 3.7.3, and its update command finds nothing newer. Use the RetroPie ZIP there, unzipped into ~/RetroPie/BIOS/.

Error: the downloaded installer does not match its expected fingerprint.

The download was cut short. Nothing was changed. Run the command again.

Cannot create ...

You do not have the right to write there. Do what the message says. It names what to run.

Not enough space on the drive holding ...

It stopped before writing. Free some space, or use --dest to pick another drive.

The game still does not start

See When a game does not start.

Next steps