Guide: PortMaster on Retro Handheld Devices

Last updated: 10JUL2022

UPDATE: PortMaster has recently created a one-stop shop for all things related to running ports on retro handhelds. I recommend checking out their website and my most recent PortMaster guide instead of the guide below; I’m leaving this page up for posterity’s sake only. To get started, head over to their Games tab, find the game you want to run, and check out their instructions on that page. If you run into any issues, their discord server is also a great place to start.

PortMaster is a new tool developed by ChristianHaitian (ArkOS developer) and a few other community members, which allows you to easily install various ports on Ubuntu-based operating systems running on the RK3326 chipset, such as ArkOS, RetroOZ, and The Retro Arena (TheRA). It also works for AmberELEC (formerly known as 351ELEC) and JELOS too! PortMaster support currently includes the following devices:

Anbernic RG351P (ArkOS final, TheRA, AmberELEC, JELOS)
Anbernic RG351M (ArkOS final, TheRA, AmberELEC, JELOS)
Anbernic RG351V (ArkOS, TheRA, AmberELEC, JELOS)
Anbernic RG351MP (ArkOS, TheRA, AmberELEC, JELOS)
Anbernic RG552 (AmberELEC, JELOS)
Anbernic RG503 (JELOS, ArkOS)
Anbernic RG353P (JELOS, TheRA)
PowKiddy RGB10 (ArkOS) and by extension the RGB10S and RGB20S
GameForce Chi (ArkOS)
RK2020 (ArkOS)
ODROID Go Advance (ArkOS)
ODROID Go Super (The RetroArena, RetroOZ)
PowKiddy RGB10 Max and Max 2 (RetroOZ)

So in this guide I’ll walk you through how to use this simple tool to get some of your favorite ports up and running on your device. Note that your device will need to be connected to the Internet for this to work!

Installation

If using ArkOS on currently supported devices (Anbernic RG351V, GameForce Chi, PowKiddy RGB10, RK2020, OGA), RetroOZ, or JELOS, you can simply update your version of the firmware via the online update tool within the OPTIONS menu. You will likely find PortMaster in the OPTIONS > TOOLS section, or the Ports section. For AmberELEC, check out this page for a detailed installation procedure and compatibility list. If you are using JELOS or The Retro Arena, you will find PortMaster in the TOOLS section (provided you are using the latest builds).

If using ArkOS Final on the RG351P or RG351M, PortMaster is easy to manually install:

  • Head over to this page and download these three files: PortMaster.sh, oga_controls, and version. Insert your SD card into your PC, then in the ROMS/tools folder, create a folder named PortMaster and add those three files.
  • Note that later ports aren’t supported on ArkOS Final, so if you want the most seamless experience for your RG351P or RG351M device, I recommend trying out AmberELEC or JELOS.
  • For ArkOS Final and TheRA, go into the OPTIONS section, then TOOLS, and you should find PortMaster there.

If you don’t want to bother with PortMaster and would like to manually install each port, head over to this page, find the zip you want, download and unzip and place the contents into your ROMS/ports folder.

Note that The Retro Arena and RetroOZ firmwares still have some limited functionality, so some ports (like Freedom Planet) are not yet working.

Adding game assets

Many of these ports (such as Cave Story, Maldita Castilla, and Spelunky) will simply work as soon as you install them. Others will require additional licensed data files in order to boot. For those games, check out the comprehensive ArkOS wiki page regarding Ports information.

Updating PortMaster

To update PortMaster, simply open the program while connected to WiFi. If there is an update available, it will prompt you for an update.

Updating ports

Some of these port packages may get updated over time, and PortMaster is future-proof in that regard. Simply update PortMaster to its latest version (you’ll be prompted when first booting the app up), and then reinstall the port onto your device. In most cases, it will not overwrite the licensed game data files you already added, or your save games, unless there was an update to the port backend that impacted previous saves (which should be relatively rare).

Contributing to PortMaster

If you are interested in contributing a port to the platform, here is more information from the ArkOS Wiki page.


Changelog

10JUL2022
– updated links and supported device list

04MAY2022
– updated link to AmberELEC

20APR2022
– updated devices and supporting firmwares

22NOV2021
– added 351ELEC section

22SEP2021
– added 351ELEC installation instructions

21SEP2021
– published guide

12 thoughts on “Guide: PortMaster on Retro Handheld Devices

  1. Thanks for the guide! Freedom Planet doesn’t seem to work for me, it loads for a minute and kicks me back to EmulationStation. And will you be adding the usual game logo, screenshot, and video for Freedom Planet?

    Like

    1. download PortMaster.zip from github and unzip whole archive to tools folder rather than just the 3 files mentioned in article

      Like

  2. Using the new Retro Oz 0.60 build and can’t find portmaster anywhere. Looked under Ports and it’s not there, nit under OPTIONS>TOOLS either. Thanks for everything you do Russ!

    Like

  3. So I love playing Super Mario War with my family. I recently purchased a rg353v and successfully loaded Super Mario War from PortMaster. When I launch this game, however, I am finding that there is an issue. When the first screen pops up, it asks, “Would you like to start a net play session?” and unless I physically plug in a keyboard, I am not sure how to remap my d-pad and buttons so that I can just select, “Yes” or “No” without needing to carry around a keyboard. I am not finding any way to map buttons and being new to this whole thing, I could use a hand. Any help is greatly appreciated!

    Like

  4. hello, Im trying to get portmaster working on my rg351p for a long time without success. If you have any suggestions I would be really happy.

    Like

  5. If you’re having problems with PortMaster on rk3326, Rgb10 max 2 or rg351p, use an older version and do not update. I got version 6.51 to work on retroOZ on my Max 2 but it won’t boot after you update PortMaster to latest which uses newer SDL binaries for the UI.

    Like

  6. I didn’t think I’m the worst at technology, but so much of this is going so far over my head. I want to learn how to do all these things, but all the “beginner friendly” stuff isn’t as beginner friendly as I need it to be. Or maybe I’m beginning waaaaay far back from where the presumed “beginners” are. I need someone to talk to me like a child I guess while explaining the basics, cause I just don’t understand. RGC is definitely one of the easier ones to understand, but I still end up going crosseyed after about 20 seconds of trying to read the information. It feels impossible to really get into this stuff when everyone uses so much jargon. Is it always this hard when starting? Or am I just an idiot?

    Like

  7. Hello, I can download with postmaster, the files are in the folder, but the X55 port game can not find anything on the menu and show empty like there is nothing there. Any sugestions?

    Like

Leave a comment