4.0 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 it again with your folder:
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
Ctrl+C stops it. 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:
109/109 present (109 verified, 0 wrong hash)
Undo
Every file it replaces goes to a retrobios-backup folder next to your BIOS
folder. The last lines say how to put 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.
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. Run the command on a computer, with
--platform retropie --dest \\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 cannot write there. Do what the message says.
Not enough space on the drive holding ...
Nothing was written. Free some space, or pick another drive with --dest.
The game still does not start
See When a game does not start.