Home › FAQ
Questions
The ones people ask first, with short answers
Not here? Get it has the three steps and every handheld, and your first evening shows the first start with pictures.
Which handhelds does it run on?
It is made on, and played every day on, the Retroid Pocket Mini V2. We have also played it on the AYN Odin 2 Mini and Anbernic's RG35XX Plus and SP, and booted it on the RG28XX.
Others that ROCKNIX supports with the same chips are on the list but nobody has tried them yet: Retroid Pocket 5, Flip 2, Pocket 6, the Anbernic RG34XX, RG40XX and friends. If you have one, tell us how it went. Every model on GitHub.
The TrimUI Brick runs it from a card of its own, more below. New and still experimental: a card for RK3566 handhelds, and a beta that runs inside dArkOS on 640×480 handhelds such as the R36S (Get it).
Is it a frontend or an OS?
pocket-ui OS is the system for your handheld: a ready-to-flash card with its own bootable image (built on ROCKNIX) and its own game player, or an install on a system you already have (ROCKNIX, or a card of its own on the TrimUI Brick). It is made for Anbernic, TrimUI, Retroid and AYN handhelds.
Is it free?
Yes. It is free and open source (GNU GPL, version 2 or later), with no accounts and no ads. Made by Robby Czesany with AI coding agents, as a hobby. It comes with no games.
What does it replace?
Nothing on your handheld. pocket-ui OS lives on its own card: your handheld's own system stays on its card, and switching cards switches systems.
Already on ROCKNIX and added pocket-ui on top? Then it takes the place of ROCKNIX's menu, and ROCKNIX itself stays: the system, the emulators, RetroArch and PortMaster. ROCKNIX's own menu is still there: hold SELECT + START for a second and pick it.
pocket-ui is based on ROCKNIX. It is not made or endorsed by the ROCKNIX team.
Does it touch my games and saves?
No. Installing leaves your games, saves and ROCKNIX settings where they are. Your games stay ordinary files in ordinary folders.
Save states don't travel between emulators, so save inside the game first if you switch. It's an alpha: copy your saves before you install.
How do I get games on?
pocket-ui has none, so bring your own. On your handheld open Settings → Games → Add games:
- From your phone. Press Y, scan the code and pick your games. They land in the right folder by themselves.
- From your computer. Switch on File sharing, open the address it shows and drop the games into the folder of their system (
gba,snes…). - No Wi-Fi? The RG28XX and RG35XX 2024 cards have a GAMES drive your computer can open (on a card of 16 GB or more), and the TrimUI Brick card has its
Romsfolder.
An empty card also offers a starter pack of free homebrew games. Step 3 on the Install page.
A game won't start?
Open Settings → Games → Game check. It goes through your card and says, in plain words, what is in the way: a missing or wrong BIOS, a disc without its file (a .cue with no .bin), an empty file, a zip with no game in it, a game in the wrong folder, or the same game twice.
Each line says what to do. It only looks: it never deletes a game, and it never touches your saves. Press A on a game to see what is wrong with it. Adding games, step by step.
I'm in a game. How do I get back to the menu?
Tap HOME. The game pauses and the menu opens over it: Continue, Save, Load, Options and Save & quit. START opens the quick settings (brightness, volume, Wi-Fi) from any row. B or another tap on HOME takes you back into the game.
Save & quit keeps the moment you are at, so the next start continues from there. Pictures in the guide.
Why do some games on my shelf stand open? How do I start over?
An open case means a moment is waiting: you left that game with a saved moment. Your last five games stand a little open, and A says Continue and puts you straight back where you were. On Game Boy, Super Nintendo, Game Boy Advance and PlayStation that takes a fraction of a second; PlayStation 2 and GameCube boot first, so they take longer.
To start a game from the beginning, open the pause menu (HOME), go to Load and pick From the start at the end of the list. Your own saves stay, and so does the waiting moment until your next Save & quit replaces it. If you don't want your place kept, switch off Settings → Playing → Continue where I quit: Quit then saves only the game's own saves.
I only have a few games, or I want it dead simple. Is there a calm look?
Yes: the Easy look (Settings → Look → Layout, or as its own row on the first start). You see your games one at a time. Left and Right choose, A plays or continues, X opens the game's card, and HOME opens the quick settings (in a game: Continue, Save & quit and More). Everything is bigger and quieter than usual, and nothing is drawn over the game.
What is Just Play?
A row on Home, right above Continue. Press A and a game starts, with nothing to choose. It picks a game you began and haven't finished first, then a starred one you never played, then any new one, and it leaves out the game you played last while there is something else. A game you left open comes back where you left it.
Which emulators does it use?
Mostly pocket-ui's own player for Game Boy, Game Boy Color and Advance, NES, Super Nintendo, Mega Drive, PlayStation, Nintendo 64, PSP, Dreamcast, Nintendo DS, Saturn and more, using the same cores as RetroArch. For the big ones it starts ROCKNIX's emulators and puts its pause menu on top: PlayStation 2, GameCube and Wii, 3DS. Everything else starts with ROCKNIX's default emulator, and RetroArch is always there.
Some heavy systems run well on one handheld and not on another. The Add games page says so where it matters.
How do I remove it?
Take the card out and put your original card back in: your handheld is as it was.
Added pocket-ui on top of ROCKNIX? Hold SELECT + START for a second, pick ROCKNIX's own menu, then start Ports → Uninstall pocket-ui. Your games, saves and ROCKNIX settings stay untouched.
What is Retro, and how do I switch it on?
Retro is a style for every menu: pixel letters, chunky pixel frames, a flat selection bar with a small cursor, little icons and short blips as menu sounds, with two colour sets of its own, Cocoa and Pea, each dark and light. Your shelf, the box art and Continue stay as they are.
Pick it on the first start's last step, or any time later: Settings → Look → Style → Retro. You can change it back any time.
A button on my controller does the wrong thing. Can I change it?
Yes. Settings → Controls → Controller setup (in a game: Pause → Options → Controls) gives each controller its own layout. It is kept when the controller reconnects. Press the button you want for a job; if it is already used for another, the two swap places.
Not sure what a button sends? Settings → Controls → Test buttons: every button, trigger and stick lights up as you press it. Hold HOME for two seconds to leave.
On a TrimUI Brick?
Yes, from a card of its own. No firmware is replaced and your normal card stays untouched: switch cards to go back to TrimUI's own system. Which systems run well, where your saves go, F1 and F2, the lights and the Power key: the Brick page. How to set it up.
Was it made with AI?
Yes, a lot of it. AI coding agents wrote most of the code, while Robby decides what gets built and tests it on his own handhelds. Some of the art starts from public-domain photos run through an AI pixel tool. We'd rather say so up front.
Is there a ready-made SD card I can just write and play?
Yes. Write the image to a card, put it in, play. The card comes without games, your handheld itself isn't changed, and the card is erased when you write it. The TrimUI Brick has a card download of its own. Which handhelds, and what to do first.
Updates come from us, not from ROCKNIX's updater. Problems with these cards: tell us, not the ROCKNIX team.
Where can I get help or talk to other users?
Come say hi on our Discord! Ask in #help, share ideas in #ideas, show off your shelf in #shelf-pics, and if you have a handheld that's still in beta, join #testers. Releases are posted in #announcements.
Found a bug? A GitHub issue is still the best place, so it doesn't get lost.
How do I report a bug?
On the handheld: Settings → Help & tools → Report a problem, then press A once. It puts what we need into one zip file in the reports folder next to your games (roms/reports on the card). Wi-Fi names, passwords and addresses are left out, and nothing is sent by the handheld itself.
Then open an issue on GitHub (Issues → New issue → Bug report), say which handheld and which game, and attach the zip. A photo of the screen helps too.
Bugs in pocket-ui come to us, not to the ROCKNIX team.
Still stuck? Ask in #help on Discord or on GitHub. What changed in each version: What's new.