mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-12 21:13:49 -06:00
Abdessamad Derraz
8f2018e7c2
An install writes retrobios-backup/<folder>.install.json beside the BIOS folder: each file it placed with its sha1, size and source, and the choice it made. The next run for the same setup and folder takes that choice when the command line chose nothing, in line mode and on the full screen, and says so. A record that cannot be read is said once and ignored. A record event reports it. With one setup found, the full screen opens on its plan, Change where one row away. The plan's Install row says the size its headline says.
182 lines
4.2 KiB
Markdown
182 lines
4.2 KiB
Markdown
---
|
|
level: start
|
|
order: 30
|
|
---
|
|
|
|
# First install, step by step
|
|
|
|
From an empty BIOS folder to a checked one.
|
|
|
|
**Needed:** internet and some free space.
|
|
|
|
## 1. Open a terminal and paste
|
|
|
|
A **terminal** is a window for typing commands. Paste the matching
|
|
line, then press Enter.
|
|
|
|
<Tabs syncKey="os">
|
|
<TabItem label="Windows">
|
|
|
|
Open the Start menu. Type **PowerShell** and open it.
|
|
|
|
```powershell title="PowerShell"
|
|
irm https://abdess.github.io/retrobios/i.ps1 | iex
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem label="macOS">
|
|
|
|
Open **Terminal**, in Applications, then Utilities.
|
|
|
|
```sh title="Terminal"
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem label="Linux">
|
|
|
|
Open a terminal.
|
|
|
|
```sh title="Terminal"
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem label="Steam Deck">
|
|
|
|
Switch to Desktop Mode and open **Konsole**.
|
|
|
|
```sh title="Terminal"
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem label="Android (Termux)">
|
|
|
|
Install **Termux**, a terminal app, and run this line. It installs Python
|
|
and asks Android for storage access: allow both.
|
|
|
|
```sh title="Terminal"
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh
|
|
```
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
On Batocera, Recalbox and similar setups, see
|
|
[Get the files](../which-pack.md).
|
|
|
|
## 2. Check the setup it found
|
|
|
|
With one setup found, it opens on step 3, its folder on the second line.
|
|
With none or several, it asks:
|
|
|
|
```
|
|
RetroBIOS: Where to install?
|
|
Found on this machine:
|
|
> <your setup>
|
|
Another setup or folder
|
|
BIOS folder: <its folder>
|
|
```
|
|
|
|
- **Right folder?** Press Enter.
|
|
- **Wrong folder, or a handheld's SD card?** Choose
|
|
**Another setup or folder** (**Change where** from step 3).
|
|
Press / and type the device (Miyoo Mini), or browse.
|
|
|
|
Arrows move, Enter chooses, Esc goes back (A and B on a handheld). On a
|
|
touch screen, tap a row twice to open it, once to tick a box.
|
|
|
|
## 3. Install
|
|
|
|
Press Enter on **Install**. **Choose systems** picks the consoles to
|
|
keep. Run it again later: it keeps that choice, one press.
|
|
|
|
**Game data** (only a game reads it) has its own row.
|
|
|
|
**Old card?** In a card reader, choose **Copy the BIOS files from an old
|
|
card or a folder**, then the card.
|
|
|
|
## 4. Wait
|
|
|
|
Esc or Ctrl+C stops, B on a handheld. Run again to resume.
|
|
|
|
## 5. Read the result
|
|
|
|
- **Done**: every file on the list is in place.
|
|
- **Finished with errors**: run it again. It retries only those.
|
|
- **Finished with files missing**: run it again online.
|
|
- **Nothing installed**: the screen says why. See [If it stops](#if-it-stops).
|
|
|
|
Screen readers: add `--plain`.
|
|
|
|
## What the command does
|
|
|
|
<!-- image: install-flow -->
|
|
|
|
## Check it later
|
|
|
|
Add `--check` to the same command. It changes nothing.
|
|
|
|
<!-- os-tabs -->
|
|
```sh
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --check
|
|
```
|
|
|
|
Result:
|
|
|
|
```
|
|
Every file on the list is in place.
|
|
```
|
|
|
|
Missing required files are named below it.
|
|
|
|
## Undo
|
|
|
|
Replaced files go to `retrobios-backup`, and `--restore` puts them back.
|
|
|
|
## If it stops
|
|
|
|
### Nothing was found here.
|
|
|
|
Choose the setup, then its folder. Where the screen offers
|
|
**Another setup or folder**, choose it first.
|
|
|
|
### Error: Python 3.8 or newer is required.
|
|
|
|
Run the command the message shows, then the installer again.
|
|
|
|
RetroPie 4.8 has Python 3.7.3, and its update finds nothing newer. Run it on
|
|
a computer, with RetroPie's `bios` share open, `\\RETROPIE\bios` from Windows:
|
|
|
|
<!-- RetroPie-Setup scriptmodules/supplementary/samba.sh:49-52 (46128cd2) shares
|
|
$home/RetroPie/BIOS as "bios", and RetroPie docs/Transferring-Roms.md:29 names
|
|
\\RETROPIE. -->
|
|
|
|
<!-- os-tabs windows: --platform retropie --dest \\RETROPIE\bios\ -->
|
|
```sh
|
|
curl -fsSL https://abdess.github.io/retrobios/i | sh -s -- --platform retropie --dest <the bios share>
|
|
```
|
|
|
|
### Error: the downloaded installer does not match its expected fingerprint.
|
|
|
|
Nothing ran, because something changed the file. Try another network.
|
|
|
|
### Cannot create ...
|
|
|
|
That folder cannot be written. Do what the message says.
|
|
|
|
### The card is full
|
|
|
|
Nothing was written. Free some space there.
|
|
|
|
### The game still does not start
|
|
|
|
See [When a game does not start](troubleshooting.md).
|
|
|
|
## Next steps
|
|
|
|
- [Get the files](../which-pack.md)
|
|
- [When a game does not start](troubleshooting.md)
|
|
- Details: [Reading the installer's output, line by line](installer.md#reading-a-run)
|