Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate, we earn from qualifying purchases at no extra cost to you. Learn more.
2026-11-16 · Setup guide
Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate, we earn from qualifying purchases at no extra cost to you. Learn more.
Rewritten, 16 November 2026. This page now covers GammaOS Next, which has replaced the original GammaOS. The earlier version of this guide had several errors. It described installing through a recovery menu with Volume Up and Power, and flashing over USB with balenaEtcher. The project's own instructions use neither. It said AetherSX2 and Citra come preinstalled. GammaOS Next sets up Daijishō and RetroArch, and you add other emulators yourself. Its device list also mixed the original GammaOS with GammaOS Next. Everything below comes from the project's own release notes and installation wiki.
GammaOS Next is a free custom Android firmware for handhelds. It is built on LineageOS, running Android 14 on most devices and Android 13 on a few older builds. It strips out bloat, adds controller friendly tools such as system wide button remapping and performance profiles, and boots into a ready made game library.
It is also not one download. There are separate builds for more than 25 handhelds, and they install in at least six different ways. This guide helps you find your device, pick the right build and follow the right route.
The Short Version
- Find your handheld in the device table below. If it is not there, GammaOS Next does not support it yet.
- Pick Lite (no Google services, faster) or Full (with the Play Store). Small devices get GammaOS Nano builds instead.
- New builds go to the project's supporters first. About 60 days later the archive password is posted in that release's notes on the project's GitHub page, and anyone can install it.
- Most installs wipe the device. Back up your saves first.
- Many devices need a Windows PC to flash. SD card devices can be set up from any computer.
- Install from the project's GitHub releases page only. Search for GammaOS Next on GitHub. Do not use reuploads.
GammaOS, GammaOS Next and GammaOS Nano
- The original GammaOS was Android 12 firmware, built on LineageOS, for Anbernic's Unisoc T618 devices (RG405M, RG405V, RG505), with a separate build for Rockchip RK3566 devices such as the RG353 series. Both of those projects are now archived. The T618 devices moved to GammaOS Next. The RK3566 devices have no GammaOS Next build.
- GammaOS Next is the current project. It is Android 13 or 14 with GammaOS's own tools built in.
- GammaOS Nano arrived in v1.4 (July 2026) for small, low memory handhelds. The release notes call it "not a launcher" but "a whole micro-OS" on top of Android. It boots straight to a console style home screen. You can still reach the normal Android interface from Quick Menu, Power, Boot Android.
What GammaOS Next Adds
From the project's feature list. Some features only exist on some devices.
- Daijishō as the launcher, with RetroArch preset for GB, GBC, GBA, NES, SNES, Genesis and PS1. BIOS files are not included. You supply your own, dumped from hardware you own.
- Universal button remapping and analog stick calibration for range and dead zones.
- Performance profiles: Max Performance, Normal Performance and Power Save, on a Quick Settings tile.
- Quick Settings tiles for shaders, black frame insertion, HDMI docking, Deep Sleep Mode, D-pad and analog swap, and more.
- System wide shaders such as CRT and LCD filters, and HDMI docking mode, which turns the built in screen off when docked. Both only on supported devices.
- DC dimming emulation to reduce flicker, and GammaEQ, a system audio equaliser on supported devices.
- Magisk root preinstalled on supported devices.
- Relaxed scoped storage, so frontends and emulators can reach your game folders with fewer permission prompts.
Which Devices Are Supported
Versions are the newest build anyone can install as of 16 November 2026. "Supporters only" means a newer build exists but its password has not been made public yet.
| Device | Newest public build | How it installs | Computer needed |
|---|---|---|---|
| Anbernic RG556, RG Cube, RG406H, RG406V, RG476H, RG Slide | Next 1.2 (Android 14), public since February 2026 | USB flash with the Unisoc tool, after a bootloader unlock | Windows |
| Anbernic RG557, RG477M, RG477V | Next 1.2.1 (Android 14), public since 21 February 2026 | USB flash with SP Flash Tool | Windows |
| Anbernic RG405M, RG405V, RG505 | Next 1.1 (Android 14), public since 22 January 2026 | Fastboot, after a bootloader unlock | Windows, macOS or Linux |
| Anbernic RG Vita Pro | Next 1.3.0 (Android 14), public from release | Write an SD card, and the device installs itself | Any |
| Anbernic RG Vita | Next 1.3.1 (Android 14), public since 26 June 2026 | USB flash with the Unisoc tool | Windows |
| Anbernic RG Rotate | Nano 1.4.1, with full Next underneath | USB flash with the Unisoc tool | Windows |
| Anbernic RG DS | Nano 1.4.1. Nano 1.4.4 is supporters only | Write an SD card, and the device installs itself | Any |
| Anbernic RG DS Plus | None yet. Nano 1.4.3 and 1.4.4 are supporters only | Rockchip SD card tool | Any |
| TrimUI Brick, MagicX Zero 40, MagicX Mini Zero 28, MagicX XU20 V32 | Nano 1.4.1 | Runs from a microSD card. Stock firmware is untouched | Windows (PhoenixCard) |
| GKD 350H Ultra | Nano 1.4.1 | Runs from a microSD card. Stock firmware is untouched | Any |
| Retroid Pocket 4 Pro, Retroid Pocket Classic, AYANEO Pocket Micro | Next 1.0 (Android 13), from mid 2025 | Fastboot, after a bootloader unlock | Windows |
| AYANEO Pocket Air Mini | Next 1.3.2 | USB flash with SP Flash Tool | Windows |
| Mangmi Air X | Next 1.2 (Android 14), public since February 2026 | Qualcomm EDL flash | Windows |
| KTPocket KT-R1, ZPG A1 Unicorn, GameMT E6 Max | Next 1.0 or 1.1, from 2025 | Fastboot, after a bootloader unlock | Windows. The KT-R1 and ZPG A1 also work from macOS or Linux |
The project lists the Retroid Pocket 5, Retroid Pocket Flip 2, Retroid Pocket Mini, AYANEO Pocket S and DMG, AYANEO Pocket Air and Powkiddy X28 as planned. That is not a release date. The AYANEO Pocket Micro 2 is not on the list. Only the original Pocket Micro is.
Before You Start
How the early access works. Each new build is a split, password protected 7-Zip archive. The project's paying supporters on Patreon or Ko-fi get the password first. Once the early access window ends, usually about 60 days, the password is added to that release's notes on GitHub. Everything in the "Newest public build" column above already has its password posted. We do not reprint passwords. Read them from the release page itself, so you know you have the right one.
What you need.
- 7-Zip or another archiver that opens split
.7z.001,.7z.002archives. Extract from the.001file only. - A good USB-C cable for USB flashing, or a reliable microSD card and reader for SD card devices. For devices that run from the card, the project recommends a 32GB or larger A2 card.
- A backup. Copy your saves, screenshots and anything else off the device. Unless your device runs GammaOS from a microSD card, installing wipes it.
- Your device's storage size, if you own an RG557, RG477M or RG477V. More on that below.
Full or Lite
- Lite has no Google services and no Play Store. It is the faster, lighter choice, and the one the project recommends on most devices. Install apps by sideloading, through Aurora Store where included, or with an updater such as Obtainium.
- Full includes the Play Store and Google services. Choose it if you need apps that depend on Google, such as some streaming apps. The project warns that Full feels slower on first boot while Google services update. Sign in, leave it on Wi-Fi with the screen on, and it settles.
Nano builds use different names. Core is Nano with a very light Android underneath and no Google apps, and the project calls it the best choice on the RG DS. Full adds the full Android build with Google apps, which is much heavier. The RG DS Plus, with 1GB of RAM, only gets Core.
NO_OC_UV and No Overclock builds. Some devices ship a second build at stock clocks and voltages. Install the standard build first. Only switch if your unit crashes, freezes or will not boot on it.
You cannot switch editions with an update. Lite to Full, or Full to Lite, needs a fresh install.
Install Route 1: The RG556 Family (USB Flash, Windows)
This covers the RG556, RG Cube, RG406H, RG406V, RG476H and RG Slide. The steps come from the project's installation wiki. They wipe the device.
Get ready.
- Download every part of the build for your exact model, plus the UnisocTools package from the project's first T820 release.
- Install 7-Zip and the Microsoft Visual C++ Redistributables the wiki lists (the latest, 2005, 2008 and 2010, both x86 and x64).
- Extract UnisocTools. It contains drivers, a bootloader unlock tool and the flash tool.
Step 1: Install the USB drivers. Run the driver installer in the UnisocDrivers folder. The Windows 10 package works on Windows 11.
Step 2: Unlock the bootloader. This erases the device.
- Power the handheld off and unplug it.
- Run UnlockBootloader.bat from the UnlockBootloader folder.
- Hold the Back button. On the RG Slide this is the button on the right side of the screen.
- While holding Back, plug the USB cable in. Let go once the screen shows the unlock text.
- Wait for "LOCK FLAG IS: UNLOCK", then unplug.
Step 3: Extract the firmware. Right click the .7z.001 file, choose 7-Zip, Extract Here, and enter the password. You get a .pac file.
Step 4: Flash.
- Run ResearchDownload.exe from the SPRD_Download_Tool folder.
- Click Load Packet and choose the
.pacfile. Check that the device name it shows matches your model. - With the handheld still off, click Start.
- Hold Back and plug the cable in. Flashing takes about five minutes. Do not unplug.
- When the tool shows Passed, the device reboots, formats itself and boots GammaOS Next. The first boot can take two or three minutes.
Updating later on this family. Version 1.2 has no over the air updater, so you update with the same tool. Load the new .pac for the same edition, open the settings (two cogwheels), untick Select All Files, and tick only FDL1, FDL2 and Super. Then flash as above. This keeps your data. Afterwards, open Quick Settings, tap the pencil and choose Reset to see any new tiles.
On Linux? The wiki links a community made Linux tool for T820 devices. The project says it has not tested it itself, though others report success.
Install Route 2: The RG DS (SD Card, Any Computer)
The RG DS runs GammaOS from its internal storage. The microSD card only carries the installer. The steps differ by version.
For the public build, Nano 1.4.1:
- Download every part of the build you want. Core is the recommended one.
- Extract the
.7z.001with the password from that release's notes. You get one.imgfile. - Write the
.imgto a microSD card of 8GB or more with an imaging tool such as balenaEtcher, Raspberry Pi Imager or Rufus. Do not just copy the file onto the card. - Power the RG DS off, insert the card and power on. It flashes its internal storage on its own.
- When it finishes, power off and remove the card. The first boot can sit on the Anbernic logo for a few minutes.
For 1.4.4 and newer, once public: these use the project's Rockchip SD Tool (Windows, macOS and Linux) instead, writing a Firmware update card. The wiki warns that ordinary imaging tools make a card the device cannot use for these versions.
Updating later. When a newer build is available to you, use Quick Menu, Settings, System Update, Update via Internet. The project says the 1.4.1 updater could fail while writing the bootloader, so from 1.4.1 an Update card, keep user data written with the Rockchip SD Tool is the safer route. From 1.4.4, every write is checked and a failed update stops instead of leaving a device that will not boot.
The Other Routes, in Brief
Follow your device's own section of the project's installation wiki. These notes tell you what you are getting into.
- RG557, RG477M, RG477V (SP Flash Tool, Windows). These come in 128GB and 256GB versions, and the flash tool needs the matching file. Check your storage size in Android Settings, Storage before you start. The wiki warns that choosing the wrong one can brick the device. If you get random crashes afterwards, the release offers a thermal safety Magisk module that trades a little peak performance for stability.
- RG405M, RG405V, RG505 (fastboot). Fresh install only. There is no upgrade path from the old Android 12 GammaOS or from stock. Turn on USB debugging and remove the microSD card first.
- RG Vita Pro (SD card). Write the image with any imaging tool. The device flashes itself. The project notes that if you ever used ROCKNIX or another mainline Linux distribution on it, you may need to unplug and replug the battery before it will restart.
- TrimUI Brick, MagicX devices, GKD 350H Ultra (run from microSD). Nothing is installed internally. To go back to stock, power off and remove the card. The Allwinner devices are written with PhoenixCard on Windows. The GKD 350H Ultra uses the Rockchip SD Tool on any computer, and the wiki says DD, Win32DiskImager and balenaEtcher will not work for it.
First Boot and Setup
- The first boot is slow. Leave it alone.
- On a Full build, sign in to Google or skip it.
- GammaOS then installs its starter apps, such as RetroArch, Flycast and Daijishō, and lands on the home screen.
- Point Daijishō at your games folder. Our Daijishō setup guide covers the details.
- Set a performance profile from Quick Settings. Normal Performance is a sensible default. Use Power Save for 8 and 16 bit systems.
Deep Sleep Mode freezes background apps to save battery. The project warns that some apps may not resume correctly. If an app or the device misbehaves after waking, turn it off in Quick Settings.
RetroArch Hotkeys
The project's hotkey page, for RetroArch on GammaOS. The Home or Back button is the hotkey.
| Action | Buttons |
|---|---|
| Open or close the RetroArch menu | Short press Home or Back, or L3 and R3 together |
| Save state | Hotkey and R2 |
| Load state | Hotkey and L2 |
| Fast forward (while held) | Hotkey and R1 |
| Slow motion | Hotkey and L1 |
| Show FPS | Hotkey and X |
| Screenshot | Hotkey and Y |
| Save, quit and resume next time | Hold Home or Back |
The last one is the useful one. Holding Home or Back saves a state and closes the game, and the next launch picks up from that state.
Updates
- GammaOS Next 1.3 and newer has an on device updater under Settings, System, System updates. It needs Wi-Fi, 25% battery or a charger, and about 2GB free. Its menu also has Install from storage for a downloaded update. The project warns not to install these packages through the Android recovery menu.
- The RG DS and RG DS Plus use Quick Menu, Settings, System Update in GammaOS Nano. Other Nano devices vary. The TrimUI Brick's move from 1.4.0 to 1.4.1, for example, needed a fresh card.
- Version 1.2 and older (including the RG556 and RG557 families) has no updater. Reflash with your device's install tool, using its keep data option where there is one.
Check which edition you have under Settings, About device. It says GammaOS Next Full or GammaOS Next Lite.
Going Back to Stock
- SD card based devices (TrimUI Brick, MagicX devices, GKD 350H Ultra): remove the card.
- Everything else: the project's wiki links Anbernic's stock images for many devices, including the RG556 and RG557 families, and explains which tool flashes them. Expect a full wipe.
Should You Install It?
Yes, if your device's stock software annoys you, you want Lite's lighter Android with no Google services, or you want the button remapping, performance tiles and shaders built in. Owners of the RG405M, RG405V and RG505 get the biggest jump, from the old GammaOS on Android 12 to Android 14.
Wait, if your device's newest build is supporters only and you do not want to pay, or your device is listed as planned.
Skip it, if you are not comfortable with a process that wipes your device and, on some models, can brick it if you pick the wrong file. Stock Android with a good frontend is a fine setup too. Our best emulation frontends guide covers that route.
Known Problems, and What to Do About Them
| Problem | What to try |
|---|---|
| The Unisoc flash tool does not see the device | Reinstall the drivers, hold Back firmly while plugging in, try another cable or port |
| The device will not boot after flashing | Check you used the build for your exact model, such as RG406H versus RG406V, then flash again |
| Random crashes or reboots | Try the NO_OC_UV or No Overclock build if your device has one. On the RG557 family, install the thermal safety module |
| Full build is slow and hot at first | Normal. Google services take a while to update. Leave it on Wi-Fi |
| An app does not come back after sleep | Turn off Deep Sleep Mode in Quick Settings |
| New Quick Settings tiles are missing after an update | Open Quick Settings, tap the pencil, choose Reset |
| The archive asks for a password you cannot find | That build is still in supporter early access. Use the newest build whose release notes include the password |
Frequently Asked Questions
What is the difference between GammaOS and GammaOS Next?
The original GammaOS was Android 12 firmware for Anbernic's T618 and RK3566 devices, and both of its projects are now archived. GammaOS Next is the current project, based on Android 13 or 14, and supports more than 25 handhelds. The RG405M, RG405V and RG505 moved from GammaOS to GammaOS Next. The RK3566 devices did not.
Is GammaOS Next free?
Yes, but new builds reach supporters first. Each release is a password protected archive. Patreon and Ko-fi supporters get the password straight away. After about 60 days it is posted in that release's notes on GitHub, and anyone can install it.
Which devices does GammaOS Next support?
Anbernic's RG556, RG Cube, RG406H, RG406V, RG476H, RG Slide, RG557, RG477M, RG477V, RG405M, RG405V, RG505, RG Vita, RG Vita Pro, RG Rotate, RG DS and RG DS Plus. Also the Retroid Pocket 4 Pro and Classic, AYANEO Pocket Micro and Pocket Air Mini, TrimUI Brick, Mangmi Air X, GKD 350H Ultra, three MagicX devices and a few others. Check the project's README for the current list.
Should I install GammaOS Next Full or Lite?
Lite for most people. It has no Google services, so it is faster and lighter. Pick Full only if you need the Play Store or apps that depend on Google. You cannot switch between them with an update, only with a fresh install.
Does installing GammaOS Next wipe my device?
On most devices, yes. Unlocking the bootloader and flashing both erase it, so back up your saves first. The exceptions are the TrimUI Brick, MagicX devices and GKD 350H Ultra, which run GammaOS from a microSD card and leave the stock firmware untouched.
What is GammaOS Nano?
A lighter version of GammaOS for small, low memory handhelds such as the RG DS, RG DS Plus and TrimUI Brick. It boots straight to a console style home screen instead of a normal Android launcher. You can still switch to the Android interface from Quick Menu, Power, Boot Android.
Does GammaOS Next work on the Retroid Pocket 5?
Not yet. The project lists the Retroid Pocket 5, Flip 2 and Mini as planned, with no date. The Retroid Pocket 4 Pro and Retroid Pocket Classic have builds.
Can I go back to stock firmware after installing GammaOS Next?
Yes. On SD card devices, just remove the card. For the others, the project's wiki links Anbernic's stock images for many models and explains how to flash them. Expect a full wipe.
Related Guides
- Daijishō setup guide
- Obtainium setup guide
- RetroArch setup guide
- Best emulation frontends
- muOS vs KNULLI vs OnionOS
- KNULLI setup guide
- Anbernic RG556 review
- Anbernic RG557 review
- Anbernic RG DS review
Rewritten 16 November 2026 from the GammaOS Next README, its release notes and its installation, update and hotkey wiki pages, read the same day. We have not flashed every device listed.


