GammaOS Next Installation - TheGammaSqueeze/GammaOSNext GitHub Wiki

Anbernic RG556 / RG-CUBE / RG406H / RG406V / RG476H / RG Slide

Installation Video Guide
Prerequisites (Windows Only)

Note: Unlocking the bootloader will factory-reset (wipe) your device.
Note: Installing GammaOS will wipe your device if your bootloader is already unlocked.
Note: If you are already running GammaOS Next and previously followed this guide, your bootloader is already unlocked and your USB drivers are installed. In that case, you can skip Step 1 and Step 2 and go straight to Step 3 and the upgrade section.

  1. Patreon Password

    • If you’re a Patreon supporter, obtain the GammaOS Next password from the Patreon post itself (https://www.patreon.com/GammaOS). The release is locked behind that password until it goes public in 60 days.
  2. 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files.
  3. UnisocTools

  4. Install Latest, 2005, 2008 and 2010 Microsoft Visual C++ Redistributable version

Step 1: Install USB Drivers

If you are already on GammaOS Next and have flashed your device previously using this guide, your drivers should already be installed. You can skip this step.

  1. Open the UnisocTools folder and navigate to the UnisocDrivers subfolder.
  2. Run the driver installer (e.g., DPInst64.exe or whichever installer is provided) to install UniSoc/Spreadtrum USB drivers.
    • On Windows 11, the Windows 10 driver package works fine.
    • After installation, you should see UniSoc-related drivers listed in Device Manager once a device is connected in bootloader mode.
Step 2: Unlock the Bootloader

If you are already on GammaOS Next, your bootloader is already unlocked. You can skip this step and go straight to Step 3 and then the upgrade section.

  1. Power off your Anbernic device completely, ensure there is no USB cable connected.
  2. In the extracted UnisocTools/UnlockBootloader folder, open the UnlockBootloader.bat script.
  3. Hold down the Back button on the device (for RG556/RG-CUBE/RG406V/RG406H, the Back button is in the same location regardless of model, on the RG Slide, this is the button on the RIGHT side of the screen).
  4. While still holding Back, connect the USB cable to your PC.
  5. The Unlock Bootloader tool will send the necessary commands; the device screen will show text indicating the bootloader is being unlocked. You can now let go of the Back button.
  6. Wait until you see a confirmation message on the device (e.g., “INFO: LOCK FLAG IS: UNLOCK!!!”). Now disconnect the USB cable and ensure the device is powered off.
Step 3: Prepare the Firmware Archive
  1. Download the GammaOS Next split archive files (e.g.:
    • RG_406H_GammaOS_Next_Full_v1.7z.001
    • RG_406H_GammaOS_Next_Full_v1.7z.002
    • RG_406H_GammaOS_Next_Full_v1.7z.003
      ) from the GitHub release.
  2. Right-click on the .7z.001 file and choose “7-Zip → Extract Here”. Enter the Patreon password when prompted.
  3. 7-Zip will automatically combine and extract all parts, producing a .pac file.
Step 4 (Fresh Install from Stock only): Flash the Firmware

Use this method if you are coming from stock firmware or any non-GammaOS ROM. This will fully wipe the device.

  1. In the UnisocTools/SPRD_Download_Tool folder, locate and run ResearchDownload.exe (or the equivalent “SPD Flash Tool”).
  2. In the Flash Tool window, click Load Packet (or the folder icon).
  3. Browse to the folder you just extracted and select the .pac file for your device model (e.g., RG_406H_GammaOS_Next_Full_v1.pac).
  4. The tool will parse the file and display information like device name (e.g., “RG406H”) and firmware version. Confirm it matches.
  5. Ensure your device is still powered off (after bootloader unlock, it should remain off).
  6. Click the Play/Start button in ResearchDownload.exe.
  7. Hold down the Back button on the device, and while holding it, connect the USB cable to your PC. The flash tool will detect the device in “Download” mode.
  8. The flashing process will begin—this takes around 5 minutes. You’ll see a progress bar; do not disconnect or power on during this step.
  9. Once flashing completes, the tool will show a “Passed” or “OK” or “Reset” status. The device will automatically reboot and perform an internal format (factory reset). Disconnect your USB cable after this point.
  10. Let the device finish formatting and then reboot. It will boot into GammaOS Next on its first launch, which can take up to 2–3 minutes as it initializes.
Step 4 (Upgrading an existing GammaOS Install only): Updating an Existing GammaOS Next Installation

Use this method if you already have GammaOS Next installed and want to update to a newer GammaOS Next version while keeping your data where possible.

Important:

  • Only update Lite → Lite and Full → Full.
  • Do not switch variant (e.g., Lite → Full or Full → Lite) using this update method. For that, perform a full flash as described in Step 4 (Fresh Install from Stock only).
  1. Prepare the new GammaOS Next version as in Step 3: Prepare the Firmware Archive and extract the .pac file for your device. Make sure you pick the same variant you are currently running (Lite or Full).
  2. Open ResearchDownload.exe from the UnisocTools/SPRD_Download_Tool folder.
  3. Click Load Packet and select the new .pac file for your device model and variant. Confirm that the device name and version look correct.
  4. Instead of pressing the Play/Start button, click the Settings icon (two cogwheels) at the top of the Research Download window.
  5. In the Download settings popup, on the Main Page tab:
    • Uncheck Select All Files.
  6. In the file list, ensure that only the following FileIDs are checked:
    • FDL1
    • FDL2
    • Super
      All other entries should be unchecked.
  7. Click OK to return to the main Research Download window.
  8. Make sure your device is powered off.
  9. Click the Play/Start button in ResearchDownload.exe.
  10. Hold down the Back button on the device, and while holding it, connect the USB cable to your PC. The tool will detect the device in “Download” mode and begin flashing.
  11. Wait for the process to complete. This update is usually quicker than a full flash, but do not disconnect the device until you see a “Passed”, “OK”, or “Reset” status.
  12. The device will reboot into the updated GammaOS Next build. First boot after an update can still take a couple of minutes while Android optimizes apps.
  13. While in the Android system, to make the new quick settings tiles appear, pull down the full quick settings/notification drawer from the top, press the Pencil icon, and press the Reset option.

If the device behaves unexpectedly after an update (e.g., repeated crashes or boot loops), you can fall back to the full-flash method in Step 4 (Fresh Install from Stock only) to perform a clean install.

Step 5: Initial Setup
  1. First Boot takes a bit longer—be patient while Android sets up file systems and initial configurations.
  2. If you installed the Full (with Google Services) build, follow the on-screen prompts to sign into your Google account or skip it.
  3. After Google setup (or skipping), GammaOS Next will run a brief configuration phase, installing key apps (RetroArch, Flycast, Daijisho, etc.).
  4. Once that completes, you’ll land on the GammaOS Next home screen. Congratulations—your device is now running the new firmware!
Troubleshooting Tips
  • If the flash tool fails to detect your device, verify:
    • USB drivers were installed correctly.
    • The Back button is held down firmly during connection.
    • USB cable and port are functional.
  • If the device doesn’t boot into GammaOS Next after flashing:
    • Double-check that you used the correct .pac for your model (e.g., RG406H vs. RG406V).
    • Ensure the device filesystem was formatted (it may reboot and re-format automatically).
    • Try unlocking the bootloader again and re-flash.
  • For any errors or unexpected behavior, post details (error messages, device model) on the GammaOS Next GitHub Issues page.

You’re all set—enjoy exploring GammaOS Next on your Anbernic T820 device! If you encounter any issues or have feedback, let me know on Discord or GitHub.

Stock Firmware (Optional)

Video guide, including FIXING OTA: https://youtu.be/AqGeh6AWo3s?t=482

Flashed using the same instructions as GammaOS Next (use SPD Factory tool instead):

To fix OTAs after flashing stock again:

SPO Factory tool: https://spdflashtool.com/factory-tool/spd-factory-tool-r27-24-2301

Linux Install

A big thank you to beebono for working this out: https://github.com/beebono/GammaOS-Linux-Tools Currently untested by me, but others have reported success.

KTPocket KT-R1

Installation Video Guide
  • No video guide available at this time.
Prerequisites
  • Grab your release

  • 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files.
    • Extract the release, open the 7z.001 file and extract all files into a folder. Enter a password when prompted.
  • ADB & Fastboot tools

    • Install ADB/Fastboot on your PC:
      • Windows: use the Universal ADB Driver installer in MTK_USB_DRIVER/ADB-and-Fastboot++_v1.1.1.msi.
      • macOS:
        brew update
        brew install android-platform-tools
      • Linux: distro-specific; e.g. Arch via android-sdk-platform-tools from AUR or Garuda with
        sudo pacman -Syu android-sdk-platform-tools
  • USB drivers (Windows only)

    1. Install Mediatek drivers: run Mediatek_Driver_Auto-Installer_5.1632.00.exe from the MTK_USB_DRIVER folder.
    2. Install UniSoc drivers: run DPInst64.exe from the MTK_USB_DRIVER/UnisocDrivers/Win* folder.
  • On the KT-R1 itself

    • Enable USB debugging and OEM unlocking in Developer Options (Settings → About → tap Build Number seven times → back to Settings → Developer options).
Step 1: Unlock the Bootloader
  1. Connect your KT-R1 via USB.
  2. In a terminal, run:
    adb reboot bootloader
    fastboot flashing unlock
  3. When prompted on the device, press Volume Up within 3 seconds to confirm.
  4. Wait for the unlock to complete (you’ll see confirmation in the terminal).
Step 2: Flash the Firmware
  1. Close any other ADB/fastboot windows.
  2. Open a terminal (or double-click the .bat) in the extracted GammaOS folder.
  3. Run the Flash script:
    • Windows: double-click FlashPartitions.bat
    • macOS/Linux:
      sh FlashPartitions.sh
    (this can take up to 10 minutes)
  4. Next, factory-reset user data (SKIP THIS IF YOU ARE UPGRADING FROM GAMMAOS V1.5.1):
    • Windows: double-click EraseUserData.bat
    • macOS/Linux:
      sh EraseUserData.sh
  5. When it finishes, press the Power button once to reboot.
Troubleshooting Tips
  • Flashing fails to start/detect
    • Re-install USB drivers and confirm fastboot devices shows your KT-R1.
  • Device gets stuck in bootloader
    • Re-run unlock (Step 2) and then flash again (Step 4).
  • Other errors
    • Provide full logs on the GitHub Issues page or in the KTPocket Discord.
Stock Firmware (Optional)
  1. Download the stock KT-R1 firmware ZIP:
    https://drive.google.com/file/d/1SD--Ns0wbqkyk8FqrhD4hCi8Jgj3Sspy/view?usp=sharing
  2. Extract it and install Mediatek drivers as above.
  3. Run SPFlashToolV6.exe from the SP_Flash_Tool_V6 folder.
  4. Under Download-XML, point to:
    G98_230726/download_agent/flash.xml
  5. Set “Download” and ensure Auto Reboot is ticked.
  6. Click Download, then plug in your KT-R1 while holding Power.
  7. When complete, it will reboot into stock OS.

ZPG A1 Unicorn

Installation Video Guide
  • No video guide available at this time.
Prerequisites
  • Grab your release

  • 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files.
    • Extract the release, open the 7z.001 file and extract all files into a folder. Enter a password when prompted.
  • ADB & Fastboot tools

    • Install ADB/Fastboot on your PC:
      • Windows: use the Universal ADB Driver installer in MTK_USB_DRIVER/ADB-and-Fastboot++_v1.1.1.msi.
      • macOS:
        brew update
        brew install android-platform-tools
      • Linux: distro-specific; e.g. Arch via android-sdk-platform-tools from AUR or Garuda with
        sudo pacman -Syu android-sdk-platform-tools
  • USB drivers (Windows only)

    1. Install Mediatek drivers: run Mediatek_Driver_Auto-Installer_5.1632.00.exe from the MTK_USB_DRIVER folder.
    2. Install UniSoc drivers: run DPInst64.exe from the MTK_USB_DRIVER/UnisocDrivers/Win* folder.
  • On the ZPG A1 Unicorn itself

    • Enable USB debugging and OEM unlocking in Developer Options (Settings → About → tap Build Number seven times → back to Settings → Developer options).
Step 1: Unlock the Bootloader
  1. Connect your KT-R1 via USB.
  2. In a terminal, run:
    adb reboot bootloader
    fastboot flashing unlock
  3. When prompted on the device, press Volume Up within 3 seconds to confirm.
  4. Wait for the unlock to complete (you’ll see confirmation in the terminal).
Step 2: Flash the Firmware
  1. Close any other ADB/fastboot windows.
  2. Open a terminal (or double-click the .bat) in the extracted GammaOS folder.
  3. Run the Flash script:
    • Windows: double-click FlashPartitions.bat
    • macOS/Linux:
      sh FlashPartitions.sh
    (this can take up to 10 minutes)
  4. Next, factory-reset user data:
    • Windows: double-click EraseUserData.bat
    • macOS/Linux:
      sh EraseUserData.sh
  5. When it finishes, press the Power button once to reboot.
Troubleshooting Tips
  • Flashing fails to start/detect
    • Re-install USB drivers and confirm fastboot devices shows your ZPG A1 Unicorn.
  • Device gets stuck in bootloader
    • Re-run unlock (Step 2) and then flash again (Step 4).
  • Other errors
    • Provide full logs on the GitHub Issues page or in the KTPocket Discord.
Stock Firmware (Optional)
  1. Download the stock ZPG A1 Unicorn firmware files:
    https://drive.google.com/drive/folders/1gVfCqoLNVQFKZEB29yDjyjpdMLcndN5C
  2. Extract it and install Mediatek drivers as above.
  3. Run SPFlashToolV6.exe from the SP_Flash_Tool_V6 folder.
  4. Under Download-XML, point to:
    H46-V2.0-XY6789ZA.12848.T0.66.V2.9-userdebug-2024.07.11-14.46(test7/download_agent/flash.xml
  5. Set “Download” and ensure Auto Reboot is ticked.
  6. Click Download, then plug in your ZPG A1 Unicorn while holding Power.
  7. When complete, it will reboot into stock OS.

GameMT E6 Max

Installation Video Guide
  • No video guide available at this time.
Prerequisites (Windows Only)
  • Grab your release

    • Download the GammaOS Next archive for E6 Max from the GitHub release page.
  • 7-Zip (or similar)

    • Install 7-Zip (or another archive tool) to extract the split .7z.001/.002/... files.
    • Extract the contents into a single folder.
  • Tools Folder

    • In the extracted archive, open the tools folder and install every application it contains (PhoenixSuit, USB drivers, ADB-Fastboot, etc.).
    • 👉 Installing these in advance is crucial before any flashing or unlocking steps.
Step 1: Enable Developer Options & USB Debugging
  1. On the E6 Max, go to Settings → About phone → tap Build Number seven times to unlock Developer Options.
  2. Back in Settings → Developer options, enable USB debugging and OEM unlocking.
Step 2: Unlock the Bootloader

Warning: If you skip this step, flashing will brick your device.

  1. Connect the E6 Max to your PC via USB.
  2. Open a command prompt in your ADB/Fastboot folder and run:
    adb reboot bootloader
    fastboot oem unlock
    fastboot reboot
  3. Once it reboots back into stock Android, proceed to the next step.
Step 3: Flash GammaOS Next with PhoenixSuit
  1. Launch PhoenixSuit (installed from the tools folder).
  2. Click the Firmware tab.
  3. Browse and select the GammaOS Next .img file for E6 Max.
  4. Ensure “Wipe data” (or similar) is checked.
  5. Press Upgrade.
  6. The device will reboot and PhoenixSuit will flash GammaOS Next automatically.

**NOTE: If you flashed the Full version of GammaOS Next, there is a bug in Google Services that will disable the wifi on first setup. Do not connect to wifi on first setup to avoid this issue. I still recommend using the Lite version for this device. **

Troubleshooting & Unbricking
  • Bootloader must be unlocked first or the E6 Max will not accept the flash and will brick.
  • To unbrick, download the factory firmware from:
    https://github.com/TheGammaSqueeze/GammaOSNext/releases/download/v.1.0.0-GAMEMTE6MAX/a527_android13_pro2_card0_secure_E6_V2.1P.img then flash it the same way (use PhoenixSuit → Firmware → select stock .img → Upgrade).
  • All other flashing steps mirror the GammaOS Next instructions above.
  • If truly bricked, hold down the power button to power down the device. Load up PhoenixSuit with the stock image, then while holding both volume buttons down on the device, plug in the USB. Once USB is plugged in, immediately keep tapping the power button with the volume buttons held down. Flashing process will begin.

Retroid Pocket 4 Pro

Installation Video Guide
  • No video guide available at this time.
Prerequisites
  • Grab your release

  • 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files.
    • Extract the release, open the 7z.001 file and extract all files into a folder. Enter a password when prompted.
  • ADB & Fastboot tools

    • Install ADB/Fastboot on your PC:
      • Windows: use the Universal ADB Driver installer in MTK_USB_DRIVER/ADB-and-Fastboot++_v1.1.1.msi.
  • USB drivers (Windows only)

    1. Install Mediatek drivers: run Mediatek_Driver_Auto-Installer_5.1632.00.exe from the MTK_USB_DRIVER folder.
    2. Install UniSoc drivers: run DPInst64.exe from the MTK_USB_DRIVER/UnisocDrivers/Win* folder.
  • On the Retroid Pocket 4 Pro

    • Enable USB debugging and OEM unlocking in Developer Options (Settings → About → tap Build Number seven times → back to Settings → Developer options).
Step 1: Unlock the Bootloader
  1. Connect your Retroid Pocket 4 Pro via USB.
  2. In a terminal, run:
    adb reboot bootloader
    fastboot flashing unlock
  3. When prompted on the device, press Volume Up within 3 seconds to confirm.
  4. Wait for the unlock to complete (you’ll see confirmation in the terminal).
Step 2: Flash the Firmware
  1. Close any other ADB/fastboot windows.

  2. Open a terminal (or double-click the .bat) in the extracted GammaOS folder.

  3. Run the Flash script:

    • Windows: double-click FlashPartitions.bat
      (this can take up to 10 minutes)
  4. Next, factory-reset user data:

    • Windows: double-click EraseUserData.bat
  5. When it finishes, press the Power button once to reboot.

Troubleshooting Tips
  • Flashing fails to start/detect
    • Re-install USB drivers and confirm fastboot devices shows your RP4 Pro.
  • Device gets stuck in bootloader
    • Re-run unlock (Step 2) and then flash again (Step 4).
  • Other errors
    • Provide full logs on the GitHub Issues page.
Stock Firmware (Optional) Grab it from here and follow the instructions: https://drive.google.com/drive/folders/1a3IEytHEBHXsptg0ZW3Ry6A2YOisiAke

AYANEO Pocket Micro

Installation Video Guide
  • No video guide available at this time.
Prerequisites
  • Grab your release

  • 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files.
    • Extract the release, open the 7z.001 file and extract all files into a folder. Enter a password when prompted.
  • ADB & Fastboot tools

    • Install ADB/Fastboot on your PC:
      • Windows: use the Universal ADB Driver installer in MTK_USB_DRIVER/ADB-and-Fastboot++_v1.1.1.msi.
  • USB drivers (Windows only)

    1. Install Mediatek drivers: run Mediatek_Driver_Auto-Installer_5.1632.00.exe from the MTK_USB_DRIVER folder.
    2. Install UniSoc drivers: run DPInst64.exe from the MTK_USB_DRIVER/UnisocDrivers/Win* folder.
  • On the AYANEO Pocket Micro

    • Enable USB debugging and OEM unlocking in Developer Options (Settings → About → tap Build Number seven times → back to Settings → Developer options).
Step 1: Unlock the Bootloader
  1. Connect your AYANEO Pocket Micro via USB.
  2. In a terminal, run:
    adb reboot bootloader
    fastboot flashing unlock
  3. When prompted on the device, press Volume Up within 3 seconds to confirm.
  4. Wait for the unlock to complete (you’ll see confirmation in the terminal).
Step 2: Flash the Firmware
  1. Close any other ADB/fastboot windows.

  2. Open a terminal (or double-click the .bat) in the extracted GammaOS folder.

  3. Run the Flash script:

    • Windows: double-click FlashPartitions.bat
      (this can take up to 10 minutes)
  4. Next, factory-reset user data:

    • Windows: double-click EraseUserData.bat
  5. When it finishes, press the Power button once to reboot.

Troubleshooting Tips
  • Flashing fails to start/detect
    • Re-install USB drivers and confirm fastboot devices shows your device.
  • Device gets stuck in bootloader
    • Re-run unlock (Step 2) and then flash again (Step 4).
  • Other errors
    • Provide full logs on the GitHub Issues page.
Stock Firmware (Optional) Grab it from here and follow the instructions: https://drive.google.com/file/d/1KPpVTWkue0KbxrzvCuRpUPOFeTn5LWHI/view

Retroid Pocket Classic

Installation Video Guide
Prerequisites
Step 1: Flash the Firmware
  1. Open a terminal (or double-click the .bat) in the extracted GammaOS folder.

  2. Run the Flash script:

    • Windows: double-click FlashPartitions.bat
      (this can take up to 10 minutes)
  3. Next, factory-reset user data:

    • Windows: double-click EraseUserData.bat
  4. When it finishes, press the Power button once to reboot.

Troubleshooting Tips
  • Flashing fails to start/detect
    • Re-install USB drivers and confirm fastboot devices shows your device.
  • Other errors
    • Provide full logs on the GitHub Issues page.
Stock Firmware (Optional) Grab it from here and follow the instructions: https://drive.google.com/drive/folders/1e5wLbHlx5L4WwkDnL-xESMOWZ1RtOwXC

MANGMI Air X

Installation Video Guide
Prerequisites (Windows Only)

Note: A clean install of GammaOS Next or stock firmware will wipe all user data. Back up your files before proceeding.
The only exception is the optional in-place upgrade from GammaOS Next using rawprogram_unsparse0_upgrade.xml, which is designed to keep your data.

Step 1: Prepare the Device and Enter EDL Mode
  1. Power off the Mangmi Air X completely.
    Ensure no USB cables are connected.

  2. Enter EDL mode:

    • Hold Volume Down + Volume Up together.
    • While continuing to hold both buttons, insert the USB cable.
    • Keep holding until the device enumerates in Windows as
      Qualcomm HS-USB QDLoader 9008.
  3. If it does not appear as a QDLoader device, repeat the process ensuring:

    • Device was off
    • Buttons were held before cable insertion
    • Drivers are installed properly
Step 2: Launch QFIL and Load the Firmware
  1. Open QFIL from the QPST installation folder.

  2. Click Select Port.

    • Choose the entry that shows Qualcomm HS-USB QDLoader 9008.
    • If no port appears, return to Step 1 and confirm the device is in EDL mode.
  3. Ensure Flat Build is selected.

  4. In Select Programmer, click Browse and choose:

    • prog_firehose_ddr.elf inside the extracted firmware folder.
  5. In Select Flat Build, click the Load XML button. QFIL will automatically prompt you for two XML files:

    • If you are performing a new install (coming from stock, another ROM, or if you want a completely clean GammaOS Next install):

      • First select: rawprogram_unsparse0.xml
      • Then select: patch0.xml
        This path will wipe all data and is the recommended option when you are not already on GammaOS Next.
    • If you are already on GammaOS Next and want to upgrade without losing data (optional upgrade):

      • First select: rawprogram_unsparse0_upgrade.xml
      • Then select: patch0.xml
        This path is designed to preserve your existing data while upgrading the system.
        Do not use rawprogram_unsparse0_upgrade.xml if you are not already on GammaOS Next. Make sure to remove any PIN/Password/Lock screen gestures before performing any upgrades.
  6. Open Configuration → FireHose Configuration and set:

    • Device Type: emmc
    • Validation Mode: 0 - No Validation
    • Reset After Download: checked
    • Leave other values at default.

Your QFIL settings should match the reference screenshots. image image image

Step 3: Flash the Firmware
  1. Confirm the correct QDLoader 9008 port is still selected in QFIL.
  2. Click Download.
  3. QFIL will immediately begin flashing once the device is detected.
  4. Wait for Download Succeeded.
  5. The device will reboot automatically. First boot may take several minutes.

These steps are identical for both GammaOS Next and stock firmware, as well as for the optional in-place upgrade for existing GammaOS installs.

Troubleshooting Tips
  • No QDLoader port appears:

    • Reinstall Qualcomm drivers
    • Use a different USB cable or port
    • Hold both volume buttons before inserting the cable
    • Ensure the device is completely powered off
  • Flashing fails or errors shown:

    • Restart the PC
    • Reinstall drivers
    • Verify the correct files (prog_firehose_ddr.elf, rawprogram XML, patch XML)
    • Ensure you selected the correct XML for your scenario:
      • rawprogram_unsparse0.xml for new installs
      • rawprogram_unsparse0_upgrade.xml only for upgrading from GammaOS Next v.1.1.0
  • Device stuck on boot:

    • Reflash the firmware
    • Ensure you used the correct Full or Lite build
  • Device shows 32GB instead of 64GB internal storage:

    • After flashing or upgrading, check your internal storage in Android settings.
    • If it reports ~32GB instead of ~64GB, your partition layout is not fully expanded.
    • In this case, perform a new install by reflashing using rawprogram_unsparse0.xml (clean install).
    • This will wipe your data, so back up beforehand.

If issues persist, open a GitHub Issue and include screenshots or QFIL logs.

Stock Firmware (Optional)

Stock firmware (no password required):
https://mangmi.com/pages/download

Flash using the same QFIL procedure described above.

Anbernic RG405M / RG405V / RG505

Installation Video Guide
  • No video guide available at this time.
    Existing videos for GammaOS v1.5.1 (Android 12) are not applicable to GammaOS Next (Android 14).
Prerequisites

Note: This is a fresh install only. There is no upgrade path from GammaOS v1.5.1 (Android 12) or stock.
Note: Installing GammaOS Next will wipe your device, regardless of whether the bootloader is already unlocked.

  1. Patreon Password

    • If you’re a Patreon supporter, obtain the GammaOS Next password from the Patreon post itself (https://www.patreon.com/GammaOS). The release is locked behind that password until it goes public.
  2. GammaOS Next Release (T618)

    • Grab your release here:
    • Choose the correct build for your device and edition:
      • RG405M Full
        • RG405M_GammaOSNext_Full_v1.1.7z.001
        • RG405M_GammaOSNext_Full_v1.1.7z.002
        • RG405M_GammaOSNext_Full_v1.1.7z.003
        • RG405M_GammaOSNext_Full_v1.1.7z.004
        • RG405M_GammaOSNext_Full_v1.1.7z.005
        • RG405M_GammaOSNext_Full_v1.1.7z.006
      • RG405M Lite
        • RG405M_GammaOSNext_Lite_v1.1.7z.001
        • RG405M_GammaOSNext_Lite_v1.1.7z.002
        • RG405M_GammaOSNext_Lite_v1.1.7z.003
        • RG405M_GammaOSNext_Lite_v1.1.7z.004
        • RG405M_GammaOSNext_Lite_v1.1.7z.005
      • RG405V Full
        • RG405V_GammaOSNext_Full_v1.1.7z.001
        • RG405V_GammaOSNext_Full_v1.1.7z.002
        • RG405V_GammaOSNext_Full_v1.1.7z.003
        • RG405V_GammaOSNext_Full_v1.1.7z.004
        • RG405V_GammaOSNext_Full_v1.1.7z.005
        • RG405V_GammaOSNext_Full_v1.1.7z.006
      • RG405V Lite
        • RG405V_GammaOSNext_Lite_v1.1.7z.001
        • RG405V_GammaOSNext_Lite_v1.1.7z.002
        • RG405V_GammaOSNext_Lite_v1.1.7z.003
        • RG405V_GammaOSNext_Lite_v1.1.7z.004
        • RG405V_GammaOSNext_Lite_v1.1.7z.005
      • RG505 Full
        • RG505_GammaOSNext_Full_v1.1.7z.001
        • RG505_GammaOSNext_Full_v1.1.7z.002
        • RG505_GammaOSNext_Full_v1.1.7z.003
        • RG505_GammaOSNext_Full_v1.1.7z.004
        • RG505_GammaOSNext_Full_v1.1.7z.005
        • RG505_GammaOSNext_Full_v1.1.7z.006
      • RG505 Lite
        • RG505_GammaOSNext_Lite_v1.1.7z.001
        • RG505_GammaOSNext_Lite_v1.1.7z.002
        • RG505_GammaOSNext_Lite_v1.1.7z.003
        • RG505_GammaOSNext_Lite_v1.1.7z.004
        • RG505_GammaOSNext_Lite_v1.1.7z.005
    • Full includes Google Apps. Lite is recommended for maximum performance and battery life.
  3. 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003/... files.
  4. ADB & Fastboot tools

  5. Unisoc USB Drivers (Windows only)

    • Install the Unisoc USB drivers contained in the release (UnisocDrivers/DPInst64.exe).
  6. On the device (RG405M / RG405V / RG505)

    • Enable USB debugging in Developer Options.
    • Remove any microSD card before proceeding to avoid issues entering fastboot/fastbootd.
Step 1: Install USB Drivers (Windows Only)
  1. Open the UnisocDrivers folder provided with your GammaOS Next release.
  2. Run DPInst64.exe (or the appropriate installer for your OS version).
  3. After installation, when you connect the device in fastboot or fastbootd mode, Windows Device Manager should show the correct Unisoc/Android interface without warning icons.
Step 2: Unlock the Bootloader (Skip if already unlocked)

Important: Unlocking the bootloader will factory-reset (wipe) your device.
Skip this step if you already see the message
“INFO: LOCK FLAG IS : UNLOCK!!!” briefly when the device boots. In that case, your bootloader is already unlocked.

  1. Connect your device to the PC while booted into Android.
  2. In a terminal or command prompt, run adb reboot bootloader.
    • The device will reboot and display fastboot mode next to the Anbernic logo.

Option A: Chrome-based unlock (recommended for most users)

  1. Open Google Chrome and visit:
    https://thegammasqueeze.github.io/subut-rehost/
  2. Click Connect, then select the fastboot device and confirm.
  3. Click Unlock.
  4. On the device prompt:
    • Do not press Volume Down.
    • Press the Home / Back button to confirm unlock.
  5. Wait for the “Unlock bootloader success!” message on the device.
  6. Close the Chrome page.
  7. In your terminal/command prompt, run fastboot reboot fastboot to reboot directly into fastbootd.

Option B: Python unisoc-unlock (Linux/macOS or advanced users)

  1. Install the tool with pip3 install unisoc-unlock.
  2. From fastboot mode, run python3 -m unisoc_unlock.
  3. Confirm on the device using the Home / Back button (not Volume Down).
  4. After “Unlock bootloader success!”, run fastboot reboot fastboot to enter fastbootd.

You should now see fastbootd at the top of the screen on the device.

Step 3: Prepare the Firmware Archive
  1. Go to the release page:
  2. Download all split parts for your exact model and edition (for example, all RG405M_GammaOSNext_Full_v1.1.7z.00X files if you have an RG405M Full build).
  3. Place all the .7z.00X files for your chosen build in the same folder.
  4. Right-click the .7z.001 file and choose “7-Zip → Extract Here”.
  5. Enter the Patreon password when prompted.
  6. 7-Zip will automatically combine all parts, producing a GammaOS Next firmware folder containing the flashing scripts (FlashPartitions.bat, FlashPartitions.sh, EraseUserData.bat, EraseUserData.sh, etc.).
Step 4: Flash the Firmware (Fresh Install Only)

This step will completely erase your existing installation (stock, GammaOS v1.5.1, or any other ROM).
There is no in-place upgrade from GammaOS v1.5.1 to GammaOS Next.

  1. Ensure your device is in fastbootd mode and connected via USB. Use the command fastboot reboot fastboot or adb reboot fastboot to get into this mode. You will know you are in the right mode when your device shows fastbootd in large red text in screen.
  2. Close any other terminal or command prompt windows that might be using ADB/Fastboot.
  3. Navigate to the extracted GammaOS Next firmware folder.
  4. Run the Flash script:
    • Windows: double-click FlashPartitions.bat
    • macOS/Linux: open a terminal in the folder and run sh FlashPartitions.sh
  5. The script will detect the device, confirm connection, and then program all required partitions.
  6. Flashing can take up to 10 minutes. Do not disconnect the cable or power off the device.

When the script reports completion, leave the device connected for the next step.

Step 5: Erase User Data (Mandatory)

A full data wipe is required to ensure compatibility with the new Android 14 base and partition layout.

  1. In the same GammaOS Next firmware folder, run the erase script:
    • Windows: double-click EraseUserData.bat
    • macOS/Linux: run sh EraseUserData.sh
  2. This will factory-reset the device and prepare it for GammaOS Next.
  3. The process can take several minutes; the script will indicate when it is complete.

Once this step is finished, you can safely disconnect the USB cable.

Step 6: Initial Boot and Setup
  1. Press the Power button once to reboot the device.
  2. The first boot into GammaOS Next can take 1–3 minutes and may appear to hang at the Anbernic logo; this is normal while Android optimizes the system.
  3. After boot completes:
    • If you installed the Full build, follow the standard Android setup flow (you may sign into Google or skip).
    • The system will then run the GammaOS provisioning scripts (installing Daijisho, RetroArch, and other key components).
  4. When provisioning is done, you will land on the GammaOS Next home screen.

Your Anbernic T618 device is now running GammaOS Next.

Troubleshooting Tips
  • Device not detected by fastboot/fastbootd

    • Reinstall ADB/Fastboot and Unisoc drivers (Windows).
    • Use fastboot devices to check connectivity.
    • Try a different USB cable and port.
  • Flash script fails or hangs

    • Ensure no other fastboot instances are active.
    • Confirm you removed conflicting fastboot.exe outside the ADB++ path.
    • Re-extract the firmware archive in a new folder and run the scripts again.
  • Device stuck on boot logo after flashing

    • Re-run EraseUserData.bat or sh EraseUserData.sh.
    • Confirm you flashed the correct T618 build (correct device and edition).
    • If still stuck, consider restoring stock using the unbricker and then flashing GammaOS Next again.
  • Bootloader appears locked again

    • Unlocking should persist across stock and custom firmware flashes. If you no longer see “INFO: LOCK FLAG IS : UNLOCK!!!” on boot, repeat the bootloader unlock procedure.

For persistent issues, open a GitHub Issue with your device model, exact build name, and logs/output from the flash scripts.

Stock Firmware / Unbricking (Optional)

If your device fails to boot or you want to return to stock:

Use the provided unbricker tools (via UpgradeDownload.exe or equivalent) to restore stock.
Once back on stock with a known-good partition layout and unlocked bootloader, you can repeat the GammaOS Next flashing procedure from Step 2 onwards.

Anbernic RG DS

Installation Video Guide
Prerequisites

Note: This is a fresh install only.
Note: Installing GammaOS Next will wipe your device, regardless of whether the bootloader is already unlocked.

  1. Password

    • If you’re a Patreon supporter, obtain the GammaOS Next password from the Patreon post itself (https://www.patreon.com/GammaOS).
    • The release is locked behind that password until it goes public on Thursday, April 2, 2026.
  2. GammaOS Next Release (RG DS)

    • This release can be installed in two ways:
      • SD Card Install (preferred): burn an image to SD card, insert it, and it auto-flashes internal storage.
      • Fastboot Install (advanced): flash from a PC using ADB/Fastboot.
    • Choose the package that matches your install method:
      • SD Card package (preferred):
        • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.001
        • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.002
        • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.003
      • Fastboot package (advanced):
        • RG_DS_GammaOS_v1.2.2_FASTBOOT.7z.001
        • RG_DS_GammaOS_v1.2.2_FASTBOOT.7z.002
    • Both install methods provide both editions:
      • GammaOS Lite (recommended, best performance)
      • GammaOS Full (includes Google Services, noticeably slower on RG DS)
    • Recommendation: Use Lite on this device. Full includes Google Services and slows the device down significantly.
  3. 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives).
  4. SD Card Imaging Tool (for SD Card Install only)

    • You need a tool to write the .img to your microSD card (this will erase the card contents).
    • Recommended options:
      • Windows: Rufus, balenaEtcher, or dd (WSL).
      • macOS/Linux: balenaEtcher or dd.
      • Any OS: Raspberry Pi Imager can also be used to write raw images to SD cards.
  5. ADB & Fastboot tools (for Fastboot Install only)

  6. Unisoc USB Drivers (Windows only, Fastboot Install only)

    • Install the Unisoc USB drivers contained in the release (UnisocDrivers/DPInst64.exe).
  7. On the device (RG DS)

    • SD Card Install (preferred): No ADB setup required.
    • Fastboot Install (advanced):
      • Enable USB debugging in Developer Options (Settings → About → tap Build Number seven times → back → Developer options).
      • Remove any microSD card before proceeding to avoid issues entering fastboot/fastbootd.
SD Card Install (Preferred)

This method is the simplest and recommended. It will overwrite the existing Anbernic stock OS on internal storage.

Step A: Prepare the SD Card Image

  1. Place these three files in the same folder:
    • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.001
    • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.002
    • RG_DS_GammaOS_v1.2.2_SDCARDINSTALL.7z.003
  2. Right-click the .7z.001 file and choose “7-Zip → Extract Here”. Enter the password when prompted.
  3. Extraction will produce two images:
    • RG_DS_GammaOS_Full_v1.2.2_SDCARDINSTALL.img
    • RG_DS_GammaOS_Lite_v1.2.2_SDCARDINSTALL.img
  4. Choose which one to install (Lite recommended).

Step B: Burn the Image to SD Card

  1. Use an imaging tool to write the chosen .img to your microSD card (this will erase the card):
    • Rufus (Windows)
    • balenaEtcher (Windows/macOS/Linux)
    • Raspberry Pi Imager (Windows/macOS/Linux)
    • dd (macOS/Linux, or Windows via WSL)
  2. After writing completes, safely eject the SD card.

Step C: Flash Internal Storage from SD Card

  1. Insert the SD card into the RG DS.
  2. Power on the device and let it flash the onboard internal storage automatically.
  3. When flashing is finished, power off and remove the SD card.
  4. You do not need the SD card anymore after installation (you can reuse it afterward).

Then proceed to Step 4: Initial Boot and Setup below.

Fastboot Install (Advanced)
Step 0: Prepare the Firmware Archive
  1. Place these two files in the same folder:
    • RG_DS_GammaOS_v1.2.2_FASTBOOT.7z.001
    • RG_DS_GammaOS_v1.2.2_FASTBOOT.7z.002
  2. Right-click the .7z.001 file and choose “7-Zip → Extract Here”. Enter the password when prompted.
  3. Extraction will produce a folder containing both Lite and Full editions.
  4. Open the folder for the edition you want to install (Lite is recommended). You should see the flashing scripts inside:
    • FlashPartitions.bat / FlashPartitions.sh
    • EraseUserData.bat / EraseUserData.sh
Step 1: Install USB Drivers (Windows Only)
  1. Open the UnisocDrivers folder provided with your GammaOS Next release.
  2. Run DPInst64.exe (or the appropriate installer for your OS version).
  3. After installation, when you connect the device in fastboot or fastbootd mode, Windows Device Manager should show the correct Unisoc/Android interface without warning icons.
Step 2: Flash the Firmware (Fresh Install Only)

This step will completely erase your existing installation (stock, or any other ROM).

  1. Ensure your device is in fastbootd mode and connected via USB.
    • If you are booted into Android with USB debugging enabled: use adb reboot fastboot
    • If you are already in fastboot: use fastboot reboot fastboot
      You will know you are in the right mode when your device shows fastbootd in large red text on screen.
  2. Close any other terminal or command prompt windows that might be using ADB/Fastboot.
  3. Navigate to the extracted RG DS folder for your chosen edition (Lite recommended).
  4. Run the flash script:
    • Windows: double-click FlashPartitions.bat
    • macOS/Linux: open a terminal in the folder and run sh FlashPartitions.sh
  5. The script will detect the device, confirm connection, and then program all required partitions.
  6. Flashing can take up to 10 minutes. Do not disconnect the cable or power off the device.

When the script reports completion, leave the device connected for the next step.

Step 3: Erase User Data (Mandatory)

A full data wipe is required to ensure compatibility with the new Android 14 base and partition layout.

  1. In the same RG DS folder, run the erase script:
    • Windows: double-click EraseUserData.bat
    • macOS/Linux: run sh EraseUserData.sh
  2. This will factory-reset the device and prepare it for GammaOS Next.
  3. The process can take several minutes; the script will indicate when it is complete.

Once this step is finished, you can safely disconnect the USB cable.

Step 4: Initial Boot and Setup
  1. Press the Power button once to reboot the device.
  2. The first boot into GammaOS Next can take 1 to 3 minutes and may appear to hang at the Anbernic logo. This is normal while Android optimizes the system.
  3. After boot completes:
    • Follow the standard Android setup flow.
    • The system will then run the GammaOS provisioning scripts (installing Daijisho, RetroArch, and other key components).
  4. When provisioning is done, you will land on the GammaOS Next home screen.
Troubleshooting Tips
  • SD card install does not start flashing

    • Re-burn the image to the SD card and try again.
    • Try a different SD card (some cards are unreliable or incompatible).
    • Ensure you wrote the correct image (*_SDCARDINSTALL.img) and did not just copy the file onto the card.
  • Device not detected by fastboot/fastbootd (Fastboot Install)

    • Reinstall ADB/Fastboot tools.
    • Reinstall Unisoc drivers (Windows).
    • Try fastboot devices to confirm the connection.
    • Try a different USB cable and port.
  • Fastboot flash script fails or hangs

    • Ensure no other fastboot instances are active.
    • Re-extract the archive into a new folder and try again.
    • Confirm you are running the scripts from your chosen edition folder (Lite or Full).
  • Device stuck on boot logo after flashing

    • Fastboot method: re-run EraseUserData.bat or sh EraseUserData.sh.
    • If you installed Full and performance is poor, re-install using Lite.

For persistent issues, open a GitHub Issue with your device model, exact build name, and output from the flash scripts.

Stock Firmware / Unbricking (Optional)

If your device fails to boot or you want to return to stock:

Anbernic RG Vita (T618)

Installation Video Guide
  • No video guide available yet for RG Vita (T618). If one becomes available, it will be linked here.
Prerequisites (Windows Only)

Note: Unlocking the bootloader will factory-reset (wipe) your device.
Note: Installing GammaOS will wipe your device if your bootloader is already unlocked.
Note: If you are already running GammaOS Next and previously followed this guide, your bootloader is already unlocked and your USB drivers are installed. In that case, you can skip Step 1 and Step 2 and go straight to Step 3.

  1. Patreon Password

    • If you’re a Patreon supporter, obtain the GammaOS Next password from the Patreon post itself (https://www.patreon.com/GammaOS). The release is locked behind that password until it goes public in 60 days.
  2. 7-Zip

    • Install 7-Zip (or another archive tool capable of extracting split archives). You’ll need it to combine and extract the .7z.001/.002/.003 files (if your download is split).
  3. UnisocTools (RG Vita)

  4. Install Latest, 2005, 2008 and 2010 Microsoft Visual C++ Redistributable version

Step 1: Install USB Drivers

If you are already on GammaOS Next and have flashed your device previously using this guide, your drivers should already be installed. You can skip this step.

  1. Open the UnisocTools folder and navigate to the UnisocDrivers subfolder.
  2. Run the driver installer (e.g., DPInst64.exe or whichever installer is provided) to install UniSoc/Spreadtrum USB drivers.
    • On Windows 11, the Windows 10 driver package works fine.
    • After installation, you should see UniSoc-related drivers listed in Device Manager once a device is connected in bootloader mode.
Step 2: Unlock the Bootloader

If you are already on GammaOS Next, your bootloader is already unlocked. You can skip this step and go straight to Step 3.

  1. Power off your Anbernic RG Vita completely, ensure there is no USB cable connected.
  2. In the extracted UnisocTools/UnlockBootloader folder, open the UnlockBootloader.bat script.
  3. Hold down the Back button AND the Anbernic button next to the Back button on the device.
  4. While still holding both buttons, connect the USB cable to your PC.
  5. The Unlock Bootloader tool will send the necessary commands; the device screen will show text indicating the bootloader is being unlocked. You can now let go of both buttons while the process continues.
  6. Wait until you see a confirmation message on the terminal that the bootloader is unlocked.
    • Important (RG Vita): After the bootloader unlock, the screen may stay black. This is normal.
  7. Now disconnect the USB cable and ensure the device is powered off, then proceed to Step 3.
Step 3: Prepare the Firmware Archive
  1. Download the GammaOS Next Lite firmware file for RG Vita (T618):
    • ASK GAMMA FOR THIS*
  2. If the download is split (for example .7z.001/.002/.003), right-click on the .7z.001 file and choose “7-Zip → Extract Here”. Enter the Patreon password when prompted.
  3. If the download is a single archive (for example .7z), extract it normally. Enter the Patreon password when prompted (if applicable).
  4. After extraction, you should have a .pac file ready to flash.
Step 4 (Fresh Install from Stock only): Flash the Firmware

Use this method if you are coming from stock firmware or any non-GammaOS ROM. This will fully wipe the device.

  1. In the UnisocTools/SPRD_Download_Tool folder, locate and run UpgradeDownload.exe (or the equivalent “SPD Flash Tool”).
  2. In the Flash Tool window, click Load Packet (or the folder icon).
  3. Browse to the folder you just extracted and select the .pac file for RG Vita (Lite).
  4. The tool will parse the file and display information like device name and firmware version. Confirm it matches.
  5. Ensure your device is still powered off (after bootloader unlock, it should remain off).
  6. Click the Play/Start button in UpgradeDownload.exe.
  7. Hold down the Back button AND the Anbernic button next to the Back button, and while holding both, connect the USB cable to your PC. The flash tool will detect the device in “Download” mode.
  8. The flashing process will begin. You’ll see a progress bar; do not disconnect or power on during this step.
  9. Once flashing completes, the tool will show a “Passed” or “OK” or “Reset” status. The device will automatically reboot and perform an internal format (factory reset). Disconnect your USB cable after this point.
  10. Let the device finish formatting and then reboot. It will boot into GammaOS Next on its first launch, which can take up to 2–3 minutes as it initializes.
Step 5: Initial Setup
  1. First Boot takes a bit longer. Be patient while Android sets up file systems and initial configurations.
  2. Follow the on-screen prompts to complete initial setup.
  3. Once setup completes, you’ll land on the GammaOS Next home screen. Congratulations, your device is now running the new firmware!
Troubleshooting Tips
  • If the flash tool fails to detect your device, verify:
    • USB drivers were installed correctly.
    • The Back button and the Anbernic button are held down firmly during connection.
    • USB cable and port are functional.
  • If the device doesn’t boot into GammaOS Next after flashing:
    • Double-check that you used the correct .pac for RG Vita (T618).
    • Ensure the device filesystem was formatted (it may reboot and re-format automatically).
    • Try unlocking the bootloader again and re-flash.
  • RG Vita bootloader unlock note: If the screen stays black after unlocking, that is normal. Disconnect the USB cable after the unlock completes and proceed to flashing.
  • For any errors or unexpected behavior, post details (error messages, device model) on the GammaOS Next GitHub Issues page.

You’re all set. Enjoy exploring GammaOS Next on your Anbernic RG Vita (T618) device! If you encounter any issues or have feedback, let me know on Discord or GitHub.

Stock Firmware (Optional)

Original stock firmware (RG Vita):

Flashed using the same instructions as GammaOS Next (use the stock .pac instead):

  • Extract the stock firmware archive until you have the .pac file.
  • Use UpgradeDownload.exe from the RG Vita UnisocTools package.
  • Use the same button combination for download mode: hold Back + Anbernic button, then connect USB.
⚠️ **GitHub.com Fallback** ⚠️