Installing UnofficialOS

UnofficialOS is installed by downloading an image for your device, flashing it to an SD Card (or your device's internal storage) and then booting the device to start the install process.

Step 1: Download Latest

• Download the latest version of UnofficialOS for your device from the releases page.
  • You'll find download links for each device/platform we support under the "Installation Package Downloads" header.
  • Make sure to download the correct image for your device. For example; if you are installing UnofficialOS on a RG351P you would download the UnofficialOS-RK3326 image.
  • If you have any questions you can check the Home section to confirm which image you should download for your specific device.

Step 2: Flash

• First decompress the image.
• Then write the image to an SD Card using an imaging tool.
  • Common imaging tools include Rufus, Raspberry Pi Imager, and Win32 Disk Imager. If you're skilled with the command line, dd can also be used.

Step 3: Boot your device

• Insert your SD Card into your device while its off and then turn it on
• Note: Some devices may require you to set the boot order so your SD Card is loaded first. Please see documentation for your specific device to see if this applies to you.
• UnofficialOS will run through its install process and then reboot your device after its complete.
• When your device reboots it will load directly into EmulationStation; at this point you are good to go!

---

Additional Notes

• UnofficialOS operating system is stored on an Ext4 partition that can be read by LINUX but is not natively readable on Windows. Currently it is not possible to access the primary UnofficialOS Ext4 partition on Windows to add games.
• On devices that support a second sd card, the sd card can be formatted as Ext4, FAT32, or exFAT. UnofficialOS will automatically detect the second SD card on boot and make it available as game storage.
• On x86 devices UnofficialOS includes an installation tool. The installation tool can be found in the tools menu, which is one of the systems listed within ES.