Installing the Safe Shutdown and OSD Software on the PiBoy DMG

Figure 1: The files in the boot directory of a freshly flashed RetroPie image.

This tutorial explains how to install the safe shutdown script and on screen display software to a newly flashed image on a micro SD card. Our installer does not currently support Lakka due to the nature of it’s file system. Support for Lakka is currently being worked on.
1. After flashing RetroPie or any Raspbian-based distro to a micro SD card insert the card in to a computer.
2. Open the card on the computer and you should be in the /boot directory.
3. Download the custom software zip file and unzip it. The software can be downloaded here.
4. Open the unzipped folder and open the folder named “PiboyInstall”.
5. Move all of the files in the inner folder to the /boot directory on the sd card. The config.txt file may be overwritten, if prompted to overwrite the file allow it.
6. Open the cmdline.txt file with a text editor.
7. If this is an installtion on a new flashed image continue from step 7, if this is an existing working PiBoy install skip to step 8.
8. Delete the init= section and all the text following it.
9. Insert the following in it’s place:
logo.nologo snd_bcm2835.enable_compat_alsa=1 init=/bin/bash -c “mount -t proc proc /proc; mount -t sysfs sys /sys; mount /boot; source /boot/unattended”
Remember no newline are allowed in the file, all of the text must be on one line. The text to add can also be found in the README.txt file in the folder unzipped earlier.
10. If this is an exisiting PiBoy installation with the osd and shutdown software already installed add the following text to the end of the first line in the file.
init=/bin/bash -c “mount -t proc proc /proc; mount -t sysfs sys /sys; mount /boot; source /boot/unattended”
11. If the image you’re installing these mods on is based around RetroPie 4.6 or later you can continue on with this tutorial. If you are using another image you’ll need to add the dkms and raspberrypi-kernel-headers packages.
12. An internet connection may be necessary for the installation to complete. The easiest way to connect the PiBoy to the internet is to connect an ethernet cable between the PiBoy and your router. However, you can add your wifi credentials to the one-time-script.conf file. Open the file and enter your network name and password in betwen the quotes in the fields labelled “new_wifi_ssid” and “new_wifi_password”. Remove the “#” character from in front of each field and then save the changes to the file.
13. Safely eject the sd card from your computer.
14. Insert the sd card in to the PiBoy and turn it on. The PiBoy will go through several boot/reboot cycles before it is ready. This process can take several minutes. If the PiBoy DMG is connected to an external screen via the HDMI out connector you can watch the boot cycling process. Optionally, you can hold down the Start button when turning the PiBoy DMG on to force the display to show the installation process.
Article last updated on: 23 Dec 2020