Differences

This shows you the differences between two versions of the page.

--- install_batocera [2023/11/12 04:22] – add info about secure boot jumpscare atari
+++ install_batocera [2026/03/30 13:53] (current) – Fixed file name pattern lbrpdx
@@ Line 12: / Line 12: @@
 Generic instructions for most platforms are as follows:
-  - Download [[https://www.raspberrypi.com/software/|Raspberry Pi Imager]] for your operating system. {{ :install_rpi_imager_01.png?direct&640 |}}
+  - Download an image flashing tool for your operating system such as [[https://www.raspberrypi.com/software/|Raspberry Pi Imager]] or [[https://gitlab.com/bztsrc/usbimager|USBImager]]. We will be using Raspberry Pi Imager in these instructions. {{ :install_rpi_imager_01.png?direct&640 |}}
   - Download an image file from the [[https://batocera.org/#download|download section on the Batocera website]] that matches the architecture you want to use for Batocera (x86_64 for most PCs, other devices usually have their own specific image). <WRAP center round important>
 Some browsers like Chrome/Opera/Safari may take the liberty to unzip the file by themselves and poorly rename them. If the file is more than 4 GB, it is already unzipped. If your download fails, use another browser. Yes, Chrome sucks, that's a fact, use another browser.
 </WRAP>
-  - Insert the intended USB drive, SD card or hard-drive into your computer. 8 GB is the minimum for **v30** and up, 16 GB and above is recommended for full functionality (you cannot automatically download updates with only 8 GB).
+  - Insert the intended USB drive, SD card, hard-drive or SSD (you can attach one via a SATA/M.2 to USB cable) into your computer. 16 GB storage space is the minimum, 32 GB is recommended for full functionality (you cannot automatically download updates with only 16 GB).
   - Install and run Raspberry Pi Imager.
   - Click **CHOOSE OS**. {{ :install_rpi_imager_02.png?direct&540 |}}
   - Scroll down and select **Use custom**. {{ :install_rpi_imager_03.png?direct&540 |}}
-  - Select the image ''batocera-(version)-(arch)-(date).img.gz'' that you just downloaded. {{ :install_rpi_imager_04.png?direct&540 |}}
+  - Select the image ''batocera-(arch)-(version)-(date).img.gz'' that you just downloaded. {{ :install_rpi_imager_04.png?direct&540 |}}
   - Click **CHOOSE STORAGE** and select the USB drive, SD card or hard-drive. {{ :install_rpi_imager_05.png?direct&540 |}} {{ :install_rpi_imager_06.png?direct&540 |}}
-  - Click **WRITE** and confirm that it is the correct destination (triple-check it's the correct drive before proceeding, as <wrap em>all existing data on the drive will be destroyed!</wrap>) {{ :install_rpi_imager_07.png?direct&540 |}}
+  - Click **NEXT**. {{ :install_rpi_imager_07.png?direct&540 |}}
+  - Click **NO**. {{ :install_rpi_imager_07b.png?direct&540 |}}
+  - <wrap em>Confirm</wrap> that it is the correct destination (triple-check it's the correct drive before proceeding, as <wrap em>all existing data on the drive will be destroyed!</wrap>), then click **YES**. {{ :install_rpi_imager_07c.png?direct&540 |}}
   - Wait patiently for the writing to finish, this may take a while depending on the speed of the card/drive. <WRAP center round important>
 Windows may offer to format the drive thinking it is a new device, cancel this request otherwise Batocera will be wiped out.
@@ Line 87: / Line 89: @@
 ===== Mac boot order selection =====
-To access the boot selection screen on Mac, hold the ''[Option]'' (''[Alt]'' on ASCII keyboards) key while booting. On newer UEFI Macs, you may first need to turn Secure Boot to "No Security" and enable "Allow booting from external media" from the recovery mode (accessed by pressing and holding ''[CMD]'' (''[Win]'' on ASCII keyboards)+''[R]'' immediately after you see the Apple logo while booting).
+=== Before booting: Disable Secure Boot and enable booting from external media (On Newer UEFI Macs) ===
+  * Reboot your MAC, at Apple logo press and hold ''[CMD]'' (''[Win]'' on ASCII keyboards)+''[R]''
+  * Mac will starts the macOS recovery mode, select and login with your admin account.
+  * At top menu bar, select ''Utilities'' >> ''Startup Security Utility'', and enter you admin account password again.
+  * Changes Secure Boot to ''No Security'' and Allowed Boot Media to ''Allow booting from external or removable mode''.
+  * Close it and Restart your Mac.
+  * Follow instructions on next section...
+==== Startup Batocera ====
+To access the boot selection screen on Mac, hold the ''[Option]'' (''[Alt]'' on ASCII keyboards) key while booting.
 <WRAP center round tip>
@@ Line 101: / Line 114: @@
 This indicates that your machine will default to booting from this device. Hold ''[Ctrl]''+''[Return]'' (''[Enter]'' on ASCII keyboards) to confirm.
+<WRAP center round important>
+On Macbooks especially, some hardware such as the touchpad or keyboard may not be supported under Linux. Fortunately, Batocera is functional with a controller alone.
+</WRAP>
 ===== Install Batocera from Batocera =====