Installing PortMaster¶
Option 1: Already Installed (Check First)¶
Most custom firmware comes with PortMaster pre-installed.
Check these locations:
| Custom Firmware | Menu |
|---|---|
| Majority | Ports Section |
| ArkOS & ROCKNIX | Tools Section |
| MuOS | Application Section |
Found it? You're done! Skip to Using PortMaster.
KNULLI Users
Go to Ports → "Install PortMaster" and run the script once.
Option 2: Manual Installation¶
What you need
- SD card reader
- Access to your device's SD card
Download Install.PortMaster.sh
Installation Paths¶
Place the file in the correct folder:
| Custom Firmware | Folder |
|---|---|
| AmberELEC | /roms/ports/ |
| ArkOS | /roms2/ports/ |
| ROCKNIX | /roms/ports/ |
| muOS | /mnt/mmc/ROMS/Ports/ |
| KNULLI | /userdata/roms/ports/ |
| UnofficialOS | /roms/ports/ |
Installation Steps¶
- Eject SD card from computer
- Insert into device
- Navigate to Ports
- Run "Install PortMaster"
PortMaster is now in your Ports section.
Using PortMaster¶
Internet Required
WiFi connection IS needed to download ports.
Main Menu¶
- Featured Ports
- Recommended games from the PortMaster team
- All Ports
- 1448+ available ports for your device
- Ready to Run
- Free games that don't need commercial files
- Manage Ports
- Reinstall or uninstall existing ports
- Options
- Settings and runtime manager
Offline Setup¶
No WiFi?
Install runtimes separately using the Runtimes Guide.
Community guides¶
Retro Game Corps has covered PortMaster in depth. Worth a look if you'd rather follow along with someone than read reference docs.
- PortMaster Starter Guide (article, July 2024)
- PortMaster Guide: 500+ PC Games on Handhelds! (video walkthrough)
- My Favorite PC Ports on Retro Handhelds (video, a tour of what the library has)
These are made by the community, not the PortMaster team, and PortMaster has changed since they were published. The video title says 500+ games, for example, and the library is past 1448 now. Where they disagree with this wiki, the wiki is current.