pocket-ui
Get it

Home › Devices & install

Get pocket-ui OS

Three steps, one card

Flash one card, pop it in, play. Your handheld's own system stays exactly as it is.

  1. Pick your handheld
  2. Flash the card
  3. Add your games

One microSD card is all you need. pocket-ui OS, your games, your saves and your BIOS files all live on it.

Android handheld? You can also keep Android and get pocket-ui as an app (card or app?).

On your phone right now? Each card is a big download (about 1.3 GB) and flashing needs a computer. Check that your handheld is on the list, then open pocketui.xyz/install on your computer.

Pick your handheld

Click yours and the download starts: the free card, about 1.3 GB.

Anbernic

Picture garbled or shifted on an RG35XX Plus or SP? Yours has the newer screen: take its "newer screen" card. RG40XX H stays black? Take the DDR3 card. RG34XX-SP or RG-SP? Screen stays completely dark: try the DDR3 card. Sound but no picture: try the "newer screen" card. Metallic Blue, or 1 GB of RAM or less: take DDR3 + newer screen. These three cards are brand new and not tried on a real handheld yet, so tell us how it went! The original RG35XX (2023, no "Plus" or "2024" on the back) isn't supported.

Retroid

RK3566

Experimental: not yet tried on a real handheld. Read the device and installation notes before flashing. Some RG353 models need Android removed from internal memory before this card can start. Testers welcome: join #testers on Discord.

One extra step

It's an alpha, copy your saves first.

Played on means we've played on this exact model. The others share its chip and get a layout made for their screen. Tell us how yours goes!

Not on the list? Tell us which handheld you'd like.

Flash the card

You need a spare microSD card (8 GB or more; 16 GB or more for the RG28XX and RG35XX 2024) and a computer for five minutes.

  1. Open balenaEtcher or Raspberry Pi Imager, choose the file you just downloaded (no unzipping) and your card, and flash. This erases the card, so use a spare one and keep the card your handheld came with.
  2. Put the card in the first slot (TF1) and switch on.
  3. The first start sets up the card and restarts once by itself. Then pocket-ui OS says hello: pick your language, join your Wi-Fi and choose your look.

Windows says "You need to format the disk"? Press Cancel. Windows just can't read this card.

Retroid Pocket Mini V2: hold Volume Down, press Power, set Boot mode to Loader, then Start. Android stays untouched, one menu away.

Add your games

Everything goes on the same card.

No Wi-Fi (RG28XX, RG35XX 2024)? After the first start on a card of 16 GB or more, switch off and put the card in your computer: a drive called GAMES shows up. Open roms and drag your games into the folder of their system (gba, snes, psx …). BIOS files go into roms/bios. Games without box art get a home-made case; for real covers, see Box art from a computer.

With Wi-Fi: on your handheld, open Settings → Games → Add games and pick what suits you:

  • From your phone. Press Y, scan the code with your phone's camera and pick your games. They fly over Wi-Fi and land in the right folder by themselves.
  • From your computer. Switch on File sharing. The screen shows an address and a password. Open it on your PC or Mac and drag your games into the folder of their system (gba, snes, psx …). BIOS files you own go into the bios folder right next to them.
  • No games at hand? Your empty shelf offers the starter pack: a handful of free homebrew games, one press.

For these Wi-Fi options, your phone or computer and handheld have to be on the same Wi-Fi. pocket-ui OS comes with no games: bring your own.

Games in? Run Game check (Settings → Games → Game check). It spots duplicates, missing files and games that won't start, and tells you what to do. It never deletes anything.

Why not just plug the card into my computer? On handhelds with Wi-Fi, the games part of the card is a Linux drive, and Windows and macOS can't open it. So games travel over Wi-Fi. No Wi-Fi on your handheld (RG28XX, RG35XX 2024)? Your card has a GAMES drive instead, still one card.

Coming from another system?

Bring your games as they are. Copy your old card's game folders over with their names (the ways in step 3 work for that too). pocket-ui OS reads the folder names other systems use, like Game Boy Advance (GBA), GBA or Sega Genesis, and renames or moves nothing.

  • Box art that is already there (in folders like Imgs, .media, images or covers) shows up on your shelf right away. Names and descriptions from gamelist.xml files do too.
  • BIOS files go into roms/bios. Game check tells you if one is missing or in the wrong place.
  • In-game saves (.srm, .sav) keep working when they sit next to their game with the same name and the same emulator core plays it. That's the case for the common cartridge systems, from Game Boy to Nintendo 64. Saves kept in a separate saves folder aren't picked up from there: copy them next to their game.
  • Save states don't move between emulators. Save inside the game before you switch, and keep a copy of your saves.

Everything that carries over, system by system

After that

Updates come over Wi-Fi with one press: Settings → System → Updates. Your games, saves and settings stay.

Want your old system back? Switch off and put your original card back in. Nothing on the handheld was changed.

Your first evening, with pictures: the guide.

Card or app?

Both give you the same shelf, the same cases and the same Continue. The difference is what happens to the rest of your handheld.

pocket-ui OS on a card or pocket-ui for Android as an app
Whatpocket-ui OS (SD card)pocket-ui for Android (app)
SetupFlash a card, put it in, switch onInstall one app, done
Your handheldStarts straight into the shelf, like a console. Take the card out and it's exactly as beforeAndroid stays. pocket-ui is one app next to your others
FeelThe most console-like: switch on, sleep, wake up right where you wereVery close, but Android still has its say: notifications, system bars, battery saving
EmulatorsBuilt in, plus RetroArch on the cardBuilt in, or any emulator app you already have
Everything elseRetro games only, no distractionsStore, streaming, browser, all still there
HandheldsThe models on this pageAny Android handheld with Android 8 or newer (64-bit ARM)

Only want to play? Take the card. Want to keep Android, or try it in a minute? Take the app. You can also have both on the same handheld.

pocket-ui for Android

Got an Android handheld with a built-in controller, like the AYN Odin 2 Mini or a Retroid Pocket? pocket-ui runs there as an app: the same shelf, the same Continue, a player with the emulators inside. No card to flash, nothing to set up.

  1. On your handheld, download pocket-ui-android.apk (59.7 MB) and open it. Android asks once to allow installs from your browser or file manager.
  2. Open pocket-ui and allow it to read your games. Put them in a ROMs folder with one folder per system (ROMs/gba, ROMs/snes …), on the handheld or its memory card. Already have one? pocket-ui finds it.
  3. Pick a game and press A. Next time, Continue takes you right back.

Every system is built in: Nintendo DS, PSP, Nintendo 64 and Dreamcast start right away, no download.

Updates: when a new version is out, the shelf tells you once. Press A, confirm in Android, open pocket-ui again. Your games, saves and settings stay. Prefer Obtainium? Add https://github.com/robbyczgw-cla/pocket-ui, switch on Include prereleases and set the APK filter to pocket-ui-android\.apk.

Needs Android 8 or newer on a 64-bit ARM handheld. No games or BIOS files are included. Touch screens and phones work too, a controller is the best way to play.

Other ways

Something special on your desk? Open the one that fits.

Already on ROCKNIX: add pocket-ui in 5 minutes

Already playing on ROCKNIX? Keep your card, your games and your saves, and put pocket-ui on top.

  1. Download the ports installer and unzip it into roms/ports on your card. Easiest over ROCKNIX's file sharing: switch on Samba in Network Settings, then open \\<device name> on Windows or smb://<device name> on a Mac (login root, password rocknix unless you changed it).
  2. In ROCKNIX's menu, open Ports and start Install pocket-ui. Not there yet? Start → Game Settings → Update Gamelists.
  3. Press Close when it says so. pocket-ui starts.

Nothing is erased. Changed your mind? Ports → Uninstall pocket-ui puts everything back. Needs ROCKNIX 20261001 or newer. If your handheld doesn't fit, the installer says so and changes nothing.

A second card for your games (optional)

Got a second slot? Every Anbernic on this page has one. A second card is handy for a big collection or for copying without Wi-Fi. You don't need it.

  1. Take any card bigger than 8 GB, the way it comes from the shop.
  2. On your computer, make a folder called roms with one folder per system inside (roms/gba, roms/snes …) and copy your games in.
  3. Put it in the second slot (TF2). The shelf shows your games within seconds.

Good to know: while the second card is in, the shelf shows that card's games, and their saves live on it too. Take it out and restart, and the games on your first card are back.

RG28XX and RG35XX 2024: no Wi-Fi, still one card

These two have no Wi-Fi, so their card brings a drive called GAMES that any computer can open. Use a card of 16 GB or more: a smaller one works, but gets no GAMES drive.

  1. Flash the card and start the handheld once. GAMES appears after that first start, not before, so no need to flash again.
  2. Switch off and put the card in your computer. GAMES shows up like a USB stick.
  3. Drag your games into roms, one folder per system (roms/gba, roms/snes …). BIOS files go into roms/bios.
  4. Eject, put the card back in the first slot and switch on. Your games are on the shelf.

Your computer shows the card's other parts too. Leave them alone: if Windows asks to format one, press Cancel; if a Mac says a disk isn't readable, press Ignore.

Retroid Pocket 5, Flip 2, 6 and Nova Beta

Beta cards, built like the Mini V2 and Odin 2 cards (same chips). They haven't started on a real one yet, so you'd be among the first. Testers very welcome: join #testers on Discord. Android stays as it is. Original screen only, not the 12 GB models with the Visionox screen.

Pocket 5 and Flip 2: hold Volume Down + Power and look at Retroid's boot menu.

  • It says Boot mode: Loader: pick it, then Start. Nothing gets flashed.
  • It says UEFI next to Android: Retroid's UEFI doesn't start SD cards, so set up OpenABL once with ROCKNIX's guide (Pocket 5, Flip 2). No computer needed: in Android, Settings → Handheld Settings → Advanced → Run Script as Root. Run backup_abl.sh first and keep the backup, then flash_abl.sh. Android and your data stay. Then Volume Down + Power, Boot mode: Linux, Boot source: SD card, Start.

Pocket 6 and Nova: the card starts from Retroid's own UEFI entry (Volume Down + Power). Secure Boot has to be off. Falls back to the boot menu? Set up OpenABL once with ROCKNIX's guide (Pocket 6, Nova). Please tell us whether you hear the menu and a game.

Downloads: Pocket 5 · Flip 2 · Pocket 6, stick above the D-pad · Pocket 6, D-pad on top · Nova · notes and how to test

AYN Odin 2, Odin 2 Mini, Odin 2 Portal

One thing first: an Odin needs ROCKNIX's boot helper set up once, unless it already starts ROCKNIX from a card. The notes next to your download walk you through it. After that it's the same three steps: flash, card in, add your games. Testers welcome: join #testers on Discord.

Downloads: Odin 2 Mini Played on (notes) · Odin 2 (notes) · Odin 2 Portal (notes) · checksums

TrimUI Brick and Smart Pro

The Brick gets a card of its own. Nothing is flashed, and TrimUI's own system stays safe on your normal card. One card here too: your games go right onto it.

  1. Format a spare card as FAT32.
  2. Unzip pocket-ui-trimui-card-0.5.0.zip straight onto the empty card, the whole zip, not single folders. It has a hidden folder the card needs (.tmp_update; on a Mac, Cmd + Shift + . shows it).
  3. Copy your games into Roms, one folder per system (Roms/gba, Roms/snes, Roms/psx …). BIOS files go into Roms/bios. Then run Settings → Games → Game check: it spots duplicates, missing files and games that won't start, and tells you what to do. It never deletes anything.
  4. Card in, power on. Pick your language and you're on your shelf.

Want TrimUI's own system back? Put your normal card back in. The Smart Pro uses the same card and is experimental: tell us how it goes! All the steps, with the trailer. Doesn't start? Send us pocket-ui/logs/boot.log from the card.

pocket-ui beta for dArkOS

Already playing on dArkOS? pocket-ui runs right inside it, from the Ports menu. Your games and dArkOS stay on the card, ready to use. This beta welcomes reports on graphics, sound, sleep and game speed on your handheld.

  1. Put the SD card into your computer and open the ports folder on the card with your games (EASYROMS, or your second card).
  2. Unzip pocket-ui-darkos-0.5.0.zip into it: you get pocket-ui.sh and the folder pocket-ui.
  3. Card in, start dArkOS. In EmulationStation: Start → Game settings → Update gamelists.
  4. Ports → pocket-ui, pick your language, and there's your shelf. New versions come through Settings → System → Updates.

For dArkOS handhelds with 640×480 screens, including the R36S (beta, reports welcome). To remove it, delete pocket-ui.sh and the pocket-ui folder. pocket-ui isn't made by the dArkOS team, so send problems to us, with the files in ports/pocket-ui/logs. Testers welcome: join #testers on Discord.

For tinkerers

Updates come from us, not from ROCKNIX's own updater, which the card turns off. Problems with these cards: tell us, not the ROCKNIX team. Based on ROCKNIX, not made or endorsed by the ROCKNIX team. Source code and licences: the 0.5.0 source archive has pocket-ui's source for all of these cards. The licences and a written source offer for the rest are on the card in the pocket-ui-info folder.

Every handheld

Every handheld and what it plays

Snapdragon 865

  • Retroid Pocket Mini V2Played on
  • Retroid Pocket Mini
  • Retroid Pocket 5
  • Retroid Pocket Flip 2

From NES to PS2, GameCube, Wii and 3DS

Snapdragon 8 Gen 2

  • AYN Odin 2 MiniPlayed on
  • AYN Odin 2
  • AYN Odin 2 Portal
  • Retroid Pocket 6Beta
  • Retroid Pocket NovaBeta

From NES to PS2, GameCube, Wii and 3DS, plus PS3, Wii U and PS Vita (selected games)

Allwinner H700

  • Anbernic RG35XX PlusPlayed on
  • Anbernic RG35XX H
  • Anbernic RG35XX Pro
  • Anbernic RG35XX 2024
  • Anbernic RG35XX SPPlayed on
  • Anbernic RG28XX
  • Anbernic RG40XX H
  • Anbernic RG40XX V
  • Anbernic RG34XX
  • Anbernic RG34XX-SP
  • Anbernic RG-SP
  • Anbernic RG CubeXX

From NES to PlayStation, N64, Dreamcast, DS and PSP

Allwinner A133P

  • TrimUI Brick
  • TrimUI Smart ProExperimental
  • TrimUI Brick ProExperimental

Its own card, nothing flashed. Selected GBC, GBA, SNES and PlayStation games measured at full speed; N64, PSP, DS and Dreamcast to try. Set it up

Which consoles run well on which handheld · Device details on GitHub