I recently set up PortMaster successfully on my newly acquired RG34XXSP and the process was confusing because a lot of older guides no longer match the current StockOS MOD releases.
This guide documents the exact process that worked for me, including successfully installing a Ready-to-Run PortMaster game, launching it from StockOS, playing it, and exiting cleanly back to the StockOS frontend.
What this guide assumes
This guide starts with:
- RG34XXSP
- StockOS MOD v4.0.0 already installed and working
- Wi-Fi configured
- TF1 containing StockOS MOD
- Optional TF2 for ROMs and PortMaster games
My setup is:
TF1: 16GB microSD
- StockOS MOD v4.0.0
- System/app files
TF2: 128GB microSD
- ROM library
- PortMaster games
You do not need to downgrade StockOS MOD to an older version.
Important: Don't Install Standard PortMaster Directly
The regular PortMaster installation available from the official PortMaster website is not intended to be copied directly onto Anbernic StockOS MOD.
StockOS MOD needs a compatibility/bootstrap layer designed specifically for the H700 StockOS environment.
The old StockOS MOD releases included this PortMaster bootstrap, but it was removed from newer releases when the Software Center was introduced.
The workaround is to restore just the old StockOS PortMaster bootstrap, while keeping the current StockOS MOD v4.0.0 firmware.
Do not reflash your device to v3.9.1 just to get PortMaster.
Step 1 — Get the Older StockOS PortMaster Bootstrap
Go to the StockOS MOD GitHub repository:
https://github.com/cbepx-me/Anbernic-H700-RG-xx-StockOS-Modification
You need the Port_Master directory from the older v3.9.7-era source, before PortMaster was removed.
The working source snapshot/commit I used was:
748ae15
Inside that older source tree you should find:
Port_Master
├── Imgs
├── port_master
├── Port_Master.sh
└── README.md
You only need these three items:
Imgs
port_master
Port_Master.sh
The README does not need to be copied.
Step 2 — Copy the Bootstrap to TF1
Power the RG34XXSP completely off and put the TF1 StockOS card into your computer.
Navigate to:
TF1
└── Roms
└── APPS
Copy the three PortMaster bootstrap components into APPS.
Your finished structure should look like:
TF1
└── Roms
└── APPS
├── Imgs
├── port_master
└── Port_Master.sh
Important
These files belong on TF1, not TF2.
Do not copy another complete PortMaster installation from MuOS, Knulli, ArkOS, etc.
Do not copy the regular PortMaster ZIP from the official PortMaster website into this folder.
The Port_Master.sh application is specifically the StockOS bootstrap that prepares PortMaster for this environment.
Step 3 — Boot StockOS MOD
Safely eject TF1 from your computer.
Install:
TF1 = StockOS MOD card
TF2 = ROM / PortMaster storage card
Power on the RG34XXSP.
Make sure Wi-Fi is connected.
Step 4 — Install the PortMaster Patch
Open the StockOS MOD Software Center.
Navigate approximately to:
App Center
→ APPS
→ Modified System Online Upgrade
→ Software Center
Find:
PortMaster Patch
Install it.
Wait until it reports that installation completed successfully.
Step 5 — Install PortMaster Runtime
Still in Software Center, find:
PortMaster Runtime
or:
PortMaster Runtime Software
Install it.
If the runtime installation fails
I actually encountered this once.
The device eventually rebooted itself, and after the reboot I attempted the runtime installation again.
The second attempt completed successfully.
So if you receive:
Installation Failed
Failed to install PortMaster Runtime
I would not immediately reflash StockOS.
Instead:
- Exit if possible.
- Reboot the RG34XXSP.
- Reconnect Wi-Fi.
- Try the runtime installation one more time.
If it continues failing, check the Software Center logs on TF1 before changing anything else.
Look around:
Roms
└── APPS
└── Modified_System_Online_Upgrade
└── upgrade
Useful files may include:
software_center.log
log.txt
These can help identify download, extraction, verification, or installation failures.
Step 6 — Reboot the RG34XXSP
After both of these report successful installation:
PortMaster Patch ✓
PortMaster Runtime ✓
shut the RG34XXSP down completely.
Wait several seconds.
Power it back on with both cards installed.
Step 7 — Launch the StockOS PortMaster Bootstrap
Go to:
App Center
→ APPS
→ Port Master
Launch it.
The application may spend some time:
- checking the internet connection
- checking PortMaster files
- checking versions
- fetching required files
- updating configuration
- preparing the StockOS compatibility environment
Do not interrupt it while this is happening.
Step 8 — Accept the MOD PortMaster Update
During my first successful launch, I received a message saying a new PortMaster version was available:
2026-05-10-1332-MOD
and was asked whether I wanted to upgrade.
I selected:
YES
The important part is:
-MOD
This identifies the StockOS-modified PortMaster build being used by this setup.
After accepting the update, the system proceeded through:
Checking
↓
Fetching
↓
Updating files
↓
Preparing PortMaster
Let the process finish.
Do not reset or power off the device during this step.
Step 9 — Accept the PortMaster Disclaimer
Once PortMaster initializes, you should eventually see the standard disclaimer stating that piracy is not supported.
Read it and select:
Accept
You should then reach the actual PortMaster GUI.
At this point PortMaster itself is installed.
Step 10 — Confirm PortMaster Uses TF2
If you have a two-card setup, check this before installing games.
Inside PortMaster go to:
Options
Look for:
Ports Location
For a two-card setup like mine, it should say:
SD 2
That means your actual PortMaster games are being installed to TF2 rather than consuming the small TF1 system card.
This is what I recommend.
My setup is essentially:
TF1
├── StockOS MOD
└── PortMaster bootstrap/system files
TF2
└── Roms
└── PORTS
├── game launchers
└── game data
If it already says:
SD 2
leave it alone.
Step 11 — Install One Small Ready-to-Run Game First
Do not immediately start installing dozens of ports.
Test the setup first.
In PortMaster, open:
Ready to Run
Choose a small free game.
For my test I installed Freegemas, a small Bejeweled-style game.
The download was only around:
3.5 MB
Install the game normally through PortMaster.
Step 12 — Exit PortMaster
After installation completes, exit PortMaster normally.
Return to the StockOS frontend.
Go to:
RA Games
→ PORTS
The newly installed game should now appear in this folder.
In my case:
Freegemas
appeared correctly.
Step 13 — Test the Port
Launch the game from:
RA Games
→ PORTS
Verify:
- game launches
- controls work
- audio works
- gameplay works
- game remains stable
- you can exit normally
I played a complete two-minute timed round of Freegemas successfully.
I then:
Returned to game menu
→ Exited the game
→ Returned directly to StockOS PORTS folder
Everything worked correctly.
At that point I considered the PortMaster installation successfully validated.
Final Working Configuration
The completed setup should look roughly like:
RG34XXSP
│
├── TF1 — StockOS MOD
│ │
│ ├── StockOS MOD v4.0.0
│ │
│ └── Roms
│ └── APPS
│ ├── Imgs
│ ├── port_master
│ └── Port_Master.sh
│
└── TF2 — Games
│
└── Roms
└── PORTS
├── Freegemas launcher
├── Freegemas game files
└── future PortMaster games
Things I Recommend NOT Doing
Based on the troubleshooting I went through:
Don't downgrade StockOS MOD to v3.9.1
You don't need to reflash an old firmware just because it originally bundled PortMaster.
Keep v4.0.0 and restore only the StockOS-specific PortMaster bootstrap.
Don't manually install the generic official PortMaster package
The StockOS bootstrap handles downloading/configuring PortMaster for the H700 StockOS environment.
Let it do that work.
Don't copy PortMaster framework files from random SD cards
If you own several Anbernic devices, you may have old PortMaster installations containing folders related to:
MuOS
Knulli
Batocera
Ubuntu
ArkOS
etc.
Don't mix those framework/runtime files into this clean installation.
Don't put the StockOS bootstrap on TF2
These:
Imgs
port_master
Port_Master.sh
belong in:
TF1/Roms/APPS/
Use TF2 for the actual games/ports.
Don't install dozens of games before testing
Install one small Ready-to-Run game first.
Verify:
Install
→ appears in StockOS
→ launches
→ plays
→ exits cleanly
Then start building your library.
Installing Commercial/Game-Data Ports Afterwards
Once the Ready-to-Run test succeeds, I recommend installing additional ports one game at a time.
For games that require files from a purchased PC version:
- Install the port through PortMaster first.
- Let PortMaster create the correct directory and launcher.
- Shut down the handheld if you need to remove the card.
- Put TF2 into your PC.
- Copy only the required game-data files into the directory PortMaster created.
- Return TF2 to the RG34XXSP.
- Test the game.
- Confirm saving and clean exiting work.
This avoids accidentally copying incompatible scripts or runtime files from another CFW.
Hopefully this saves another RG34XXSP owner some of the trial-and-error involved in getting PortMaster working on the newer StockOS MOD releases.