RGUI-Pi

Advanced user UI and RGB-Pi OS4 to Pi5 Migration tool

GPL-3.0 License

Stars
5
  • RGUI-Pi is an advanced CRT only RGUI implementation using rtomasa Retroarch Dynares for pixel perfect gaming.
  • It also has the ability to migrate rtomasa OS4 from the original image to the Pi Zero2, Pi3 and Pi5. This utilizes no changes to the original OS4 code as OS4 ui is closed source.
    • This is unsupported and please dont ask the rgbpi devs for support. The primary function of this image is Pi5 with minimal to no testing on other Pi's
  • Add more cores with https://github.com/forkymcforkface/RGBPi-Extra/

How to Migrate OS4 to Pi5

  • Download the latest release and burn to an SD card, insert into the Pi5
  • Download OS4 and burn to a normal USB drive (not sd card), insert into Pi5 USB port.
  • Turn on the Pi5 with both the SD card and the USB drive plugged in and wait for the migration to complete (about 2mins)
  • Here is a video of the process
  • For audio in OS4 UI (games work with any DAC), You Must use a USB Audio DAC that shows up as 'Headphone' in aslamixer this specific USB audio DAC works for me. Some people have tried other DACs with some success.

How to change settings for different hats, cables

  • After migrating OS4, scan for games before mounting a drive. Open ports and there are options available:
    • Lo-tech VGA888 (24bit color on Pi5, looks to be 18bit on pi3, pi4. not sure why)
    • RGB-Pi cable (full 18bit color)
    • VGA666 (does not display full 18bit colors)
  • 120hz VGA Option. Must apply this with a normal CRT first.
  • You must run the pi zero2 Pi3 script if you are running on those systems.
  • USB Audio Dac required even for Pi Zero2, Pi3, Pi4. Can probably be fixed, but pi5 is the focus.

Build Sources


Self Install* (Work in progress, do not use)

  • Download the latest Bookworm release
  • Plug into Pi5
  • Get IP address
  • SSH Login as pi user
  • Run the below command and sit back until RGUI-Pi appears
sudo apt install git -y && git clone --depth=1 https://github.com/forkymcforkface/RGUI-Pi.git && cd RGUI-Pi && chmod +x Install-RGUI.sh && ./Install-RGUI.sh

Things to Note

  • Interlacing is not possible with gpio on pi5 so systems that utilize it are running at half height to keep it progressive resolution. similar to how the Pi3 OS2 runs.
  • Kodi disabled (do not use)
  • System is overclocked out of the box for Pi4 and Pi5. Fan is required. Overclocking does not void the raspberry pi warranty.
  • The OS4 UI is half the frames and feels slow, its an incompatibility with OS4 UI and the Pi5 hardware. I cannot fix this since the UI is closed source.
  • If using a pi3 or pi zero2 make sure to scan for games after the first os4 boot, go to ports and apply the pi3/zero2 timings patch.
  • pi pw prior to OS4 migration: rguipi