Skip to content

PortMaster

christianhaitian edited this page Nov 4, 2021 · 19 revisions

What is PortMaster?

Inspired from Kris Henriksen's AnberPorts, PortMaster is a simple tool that allows you to download various game ports that are available for ArkOS, RetroOZ, and TheRA for RK3326 based devices. Support for 351Elec is being worked on as well. A list of ports from here that work on 351Elec are available here. A number of ports have been tested and confirmed working with TheRA and RetroOZ. Ports such as Freedom Planet and Maldita Castilla will be working for TheRA soon.

One of the goals of PortMaster is to not install or upgrade any existing OS libraries for any ports. Any of the ports that need a particular non standard library are maintained within the port's folder and made available specifically to that port during execution.

Most of the the ports available through PortMaster have been configured to launch with proper controls for the Gameforce Chi, Powkiddy RGB10, Anbernic RG351P/M/V/MP, RK2020 and the Odroid Go Advance units. Controls for the Odroid Go Super and the Powkiddy RGB10 Max are also included and have been tested but not as much as the 3.5" RK3326 devices.

How do I install PortMaster?

For ArkOS on supported devices, PortMaster was included with a recent online update. You can locate it in the Options > Tools menu.
For 351Elec, just unzip the content of PortMaster.zip to your storage/roms/ports folder then run PortMaster.sh from the Ports menu in 351Elec. If you don't have PortMaster there or need to install it manually, you can do the following:

  • Place the PortMaster folder in /roms/tools.
    • For ArkOS on the RG351V or RG351MP, if SD2 is being used for roms, installation must be in /roms2/tools/.
  • Run PortMaster from ArkOS, TheRA or RetroOZ through Options > Tools > PortMaster menu, 351Elec from Ports > PortMaster menu

Do I have to use PortMaster to install ports?

No. You can simply go to the PortMaster repo (https://github.com/christianhaitian/PortMaster), find the .zip of the port you want, download it and unzip the contents of it to the /roms/ports folder. NB : For ArkOS on the RG351V or RG351MP, if SD2 is being used for roms, unzip the port to the /roms2/ports folder instead.

How do I get more info about the ports in this repo like the sources used and additional asset needs if applicable?

You can find that information via the ArkOS Emulators and Ports information wiki link here.

If there are updates to Ports, how will that work?

Just run PortMaster and reinstall the port. This should install the latest port related files if they've been updated in PortMaster. In most cases, it should not impact any existing game data you had to provide or existing saves unless the updated port made changes to the port backend that impacts previous saves.

How can I help add ports to PortMaster?

See the packaging documentation here for more info on this. Once you're port packaging has met these minimum requirements, you can either submit a Pull Request of this port or contact me on the RGHandhelds discord for further review and advisement.