An uncompromisingly fast, small, modern, and feature-rich custom firmware for A23/A33-based handheld consoles.
Important
goodluckOS is BETA software. You will run into bugs!
Please visit The Firmware Builder. This will walk you through the steps of identifying if you have a compatible unit, and building a flashable goodluckOS image.
Latest release: 0.1.0 - Oct 10, 2026
| Feature | Stock Firmware | goodluckOS |
|---|---|---|
| Linux Version | Linux-Sunxi 3.4 | Mainline Linux 7.2 |
| Optimized Firmware | No, janky EmuElec fork | Yes, built from scratch for maximum performance |
| Optimized Binaries | No | Yes, everything compiled for armhf neon-vfpv4 |
| Boot Time | 50 seconds | 10 seconds |
| Game Launch Time | ~4 seconds | ~1 second |
| Minimum microSD Size | 16gb | 512mb |
| Maximum microSD Size | 64gb/128gb | No limit |
| TF-2 Slot | No | Yes (on supported hardware) |
| USB TTY | No | Yes |
| USB MTP | No | Yes. Plug your console into your PC and copy games without unplugging the microSD card |
| Zram | No | Yes, enabled by default |
| Swap | Yes, which will kill your microSD card | No, Zram is used instead |
| Accelerated Graphics | Yes, with old sunxi driver | Yes, with modern Lima driver |
| Speaker Audio | Yes | Yes |
| Headphone Audio | Yes | Yes |
| FN Features | No, FN button does nothing | FN button is a swiss-army knife of functionality. Check the Hotkeys section for details |
| Blue LED | Always on, annoying | Only on when the screen is off |
| Retroarch | Yes | Yes |
| Libretro Cores | Older, unoptimized cores | Modern cores |
| Launcher | EmulationStation (slow) | Puppy (fast) (Emulation Station as an optional package coming soon) |
| Autostart Apps on Boot | No | Yes |
| Ports | No | Yes, check out the Ports/Software page for the growing list of playable ports including GTA: San Andreas, Undertale, Half Life, Diablo and more! |
| In-app Overlay | No | Coming soon |
| Mountable SD Card | No, MBR is broken by default. | Yes, goodluckOS ships with a functioning MBR |
| Built-in Games | Thousands of illegal roms, so sharing the firmware is technically illegal | Comes with Chocolate Doom + a shareware doom.wad. Completely legal to distribute |
| GPL Compliant | No | Yes |
Hotkeys are quick button-combos that you can press from anywhere to perform some action.
| Buttons | Action |
|---|---|
| FN + VOL UP/DOWN | Adjust screen brightness |
| FN + DOWN | Toggle between speaker and headphone audio output |
| FN + UP | View live CPU/FPS stats |
| START + SELECT | Gracefully exit the current application |
| FN + START + SELECT | Kill (-9) the current application |
| POWER (short press) | Turns off the screen |
goodluckOS gives you a direct line into the operating system from your desktop PC so you can edit system files, monitor processes, debug configurations, etc.
To use it:
- Plug your console into a Linux PC with a usb cable via the OTG port.
- Open a terminal and run
sudo screen /dev/ttyACM* 115200 - When prompted, enter the credentials (username:
root, password:root)
Visit the Ports/Software page for a growing list of ports and software made for goodluckOS
Check out the Firmware Builder for instructions and video guides.
You'll need a backup of at least the first 128mb of the original microSD card that came with your device.
Don't have the original microSD card? Open an issue here on github, we have microSD card dumps for several hardware variants, and one of them may work for you. We'll get you sorted out.
- Headphone auto-detection. We have reason to believe some GA36-MB variants simply lack the hardware to do this.
- More LibRetro cores
- Fine tune existing LibRetro cores for best performance.
- EmulationStation (as an optional replacement for Puppy)
- USB Networking
- CPU Overclocking
Every known variant of the GA36-MB is supported. This includes "Tekko" branded devices.
The GA36-MB family of devices ship with at least two different display panels. gooduckOS supports both, but we haven't yet found a good way to determine which panel you have ahead of time. For now, just try both until one works.
If the Firmware Builder tells you your device is not supported, you may have a new variant we've never seen before. In that case, send us your script.bin file so we can verify that goodluckOS is safe for your device. We'll update you when we support it.
- R36MAX
- F35v
- Gaminja Batocera K36 -- [Nov 8, 2026 Update] This device has been purchased by our development team. Support coming soon.
- Other A23/A33-based devices
Know of another Allwinner-based handheld not listed on this page? Open a new Issue and let me know!
If you have one such device, and some spare time, leave an issue on Github and we'll work with you to build support for it and get it running on your hardware.
Alternatively, consider contributing to the Device Fund so we can purchase new consoles and port goodluckOS to them.
Puppy is goodluckOS' default application launcher. It's what you see when you start goodluckOS. Read more about Puppy here.
Plug the console into your PC with a USB cable and open GA36MB -> HOME (Windows: This PC; Linux: your file manager; macOS needs an MTP app such as OpenMTP). Or plug the SD card into your PC and open up the HOME partition. In there you'll find a roms folder with a few subfolders for each system. Add your roms to those.
If the console was connected to a charger when it booted (no PC), restart it before plugging it into a PC to get MTP; the serial console works either way. Games copied while Puppy is open show up after you reopen it.
On a PC's USB the battery charges up to 90% and then rests, so a console left plugged in for days doesn't wear its battery out. It charges again once the cable comes out and goes back in, or at 50% if a game drains it while plugged in. A charger with no PC behind it charges to full.
To add custom art to Puppy, add an image file into the icons folder in your rom folder with the same name as the rom file. (eg. if your game is roms/snes/super-mario.smc, your image would be roms/snes/icons/super-mario.png)
A FAT32/exFAT card in the second slot is found when the console starts, and its games show up in each system's tab. Put them in a roms folder with the same system folders as HOME (roms/snes, roms/psx, roms/gba...), and covers in each folder's icons. A card with no roms folder gets the folders created the first time it's mounted; existing folders and files are never touched.
Puppy finds games by folder, not by file type: games loose on the card, or in the wrong system's folder, won't show up or won't start.
goodluckOS ships with Chocolate Doom and a shareware Doom wad.
goodluckOS will never be distributed with unauthorized copyright-protected materials. If you own the copyright to any games (or know of any permissively-licensed/CC games) that you think might make a good fit, please open an Issue! We would love to include more small, high-quality games with the OS by default.
The fantastic rincewindcz has created and maintains a growing library of ports made for goodluckOS, available for download at https://ga36.genserek.net/.
GoodluckOS uses a novel four-step containerized build system featuring Buildroot. This means the OS can be configured and built extremely easily and portably with no extra dependencies at all besides Docker and Docker Compose (or Podman).
Take a look at BUILD.MD for instructions and guidelines.
goodluckOS has been designed with a few core principles:
- The core OS will ship with at most one tool for any job. Duplicate functionality is duplicate bugs.
- goodluckOS should strive to be as battery-efficient as possible. If a not-strictly-necessary pretty UI feature uses more resources than an uglier alternative, the uglier alternative will be preferred.
- Do not reinvent the wheel. Opt to use existing packages instead of writing them from scratch so long as they don't conflict with the previous principles.
- Anything not usable by most people should be distributed as an installable package instead of being baked into the core OS.
Please keep those in mind if you intend for your work to be merged upstream :)
We're currently in the process of choosing a package-management solution for goodluckOS, so if your application/feature is not approved for merging upstream please feel free to package it up as an installable application and we would be happy to advertise it as an optional feature for goodluckOS.
Contributors should feel free to use any tool at their disposal to write their code. Good code is good code regardless who (or what) wrote it. However, large systems that have not been properly tested, documented, or are not understood by the human contributors will not be accepted until all of these conditions are met. This rule applies to both human written code and LLM-generated code.
This project is licensed under the GNU GENERAL PUBLIC LICENSE VERSION 2.0 see the LICENSE file for details.
WARNING: The GNU General Public License v2 covers this in more detail, but to re-iterate: This software has the potential to permanently damage your hardware. You alone are responsible for all damages, and the ensuing results of said damages that may occur as a result of using, or attempting to use this software.