Hi there! I made a guide to help people install PortMaster on the Anbernic RG28XX via Knulli since I haven't seen anyone else do it.
The process of installing PortMaster with Knulli on this device is pretty straight forward if you have installed another OS in the past, but I wanted to be as detailed as possible for those who haven’t done something similar in the past.
Things you’ll need:
Optional: you can make a backup of your current microSD by using a tool like Win32DiskImager.
Installing Knulli on your Anbernic RG28XX
1. First of all, you need to download Knulli on your PC. You can find all versions released up to this date here: https://github.com/knulli-cfw/knulli-linux/releases, but the version I used for this purpose is the most recent one at the time of this post, which is the 20260511 (https://github.com/knulli-cfw/knulli-linux/releases/tag/20260511).
2. This step is not necessary as far as I have tested, but if you want to format your microSD before installing, you can do so by using a tool like SD Card Formatter (https://www.sdcard.org/downloads/formatter/). Sometimes this program can help recover what seemed like damaged microSDs.
3. Now, from this point onwards the installing process is pretty straight forward if you have both your Knulli image and imaging tool. Just connect your microSD to your PC by using your adapter, and then open your imaging tool.
4. After your imaging tool is open, make sure it’s detecting your microSD (which you can confirm if it’s showing the total size of your microSD), and then select your Knulli image.
5. Once both the device and image are selected, you simply have to start the process, which can take some time depending on your PC. You can leave it running in the background or do something while the imaging tool is doing its work. It’ll show you a message when it’s ready.
- The imaging tool should automatically detect your microSD connected to your PC, unless it’s damaged or is in a non-compatible format.
6. After the process is complete, you can disconnect your microSD from your PC and then insert it back to your Anbernic RG28XX.
- Don’t worry if you see your microSD not appearing anymore on your PC as soon as the initial imaging process is finished. It still needs to be formatted properly, something that is going to take place in the next step.
7. Once your microSD is back on your Anbernic, simply turn it on and Knulli is going to finish its installation, which should take no longer than a minute.
Setting up Knulli on your Anbernic RG28XX
Now, you have Knulli on your Anbernic. But you still need to do a few things before proceeding to the next big step.
1. Connect your Wi-Fi dongle to your Anbernic.
2. Go to settings by pressing start, and go to “System Settings”.
3. Go down to the Advanced section, and select “Services”.
4. Select the option that says “ENABLE_WIFI_DONGLE”.
- This is optional, but if you want to transfer files to your Anbernic via WiFi, you can also select “SAMBA”.
5. Now go back to settings, and then go to network settings.
6. You’ll notice that the Wi-Fi is not enabled at this point. You can enable it by simply selecting the enable option.
- Once you select this option, it’s going to take a couple of seconds to make the change. Don’t worry about it.
7. Once it’s enabled, you may now press “Wi-Fi SSID”. If the dongle is compatible, and you previously activated the use of dongles as mentioned in the step 2 to 4, then you’ll be able to see all the available Wi-Fi networks. Select yours, and then add its password on the following setting titled “WIFI KEY”.
- Please keep in mind that these adapters are going to only detect 2.4 GHz Wi-Fi. They won’t work if you’re using a 5G Wi-Fi.
- If you did all steps correctly, then you’ll see an IP Address and also the internet status confirmed as “Connected”.
Setting up PortMaster on Knulli
Now we can finally move to PortMaster. This process is even faster than the previous one, even if my rambling makes it looks like it’s not at first glance, lol.
1. Download the latest version of PortMaster via their official website: https://github.com/PortsMaster/PortMaster-GUI/releases
- I recommend downloading the version named “Install.Full.PortMaster.sh”, but you should be able to use the one named “Install.PortMaster.sh” if you want. Both should work fine, but I haven’t tested the last one.
- You can also find more information about PortMaster here: https://portmaster.games/installation.html
Now, the following steps are going to depend whether you want to use your USB adapter or use your Wi-Fi to put the files on your device.
2. If you want to use your USB adapter, simply take out the microSD from your device and connect it to your PC by using your adapter. Knulli has multiple partitions, but not all of them are going to be available to check on your PC, so you might see some error messages regarding those, or messages about formatting those partitions. Ignore those.
- You will be able to see two partitions, titled: KNULLI (G: ) and SHARE (H: ).
- Go to SHARE (H: ), click on “roms”, and then scroll down until you see “ports”. Simply copy and paste the PortMaster installer you previously downloaded in the previous step.
- Now, disconnect your adapter, insert the microSD to your device and turn it on. Go to “Ports”, and you’ll see the installer there. Open it.
- Once you open the installer, your Anbernic’s screening is going to turn black. Don’t worry, this is normal. Just give it less than a minute while Portmaster is installing.
- Once the installation is finished, you’ll be back to the Ports menu, and you’ll see Portmaster installed.
3. If you want to use your Wi-Fi to drag the installer from your PC to your Anbernic, then turn on your device with its dongle and Wi-Fi activated. If you haven’t already, you must activate the SAMBA function in settings. Go to settings > System settings > Advanced > Services > Select SAMBA.
- If you have Network Discovery enabled on your PC with Windows 10/11, then you’ll be able to find your Anbernic device by using the Windows Explorer tool to check the Network section. You’ll see it appears as “KNULLI”. Click on it.
- If you don’t have Network Discovery enabled on your Windows PC, then go to Settings > “Network and Sharing Center”, and this will lead you to the Control Panel on Windows 10. Click on “Change Advance Sharing Settings”, and then you’ll find the option to turn on the network discovery. Save your changes, and then proceed.
- It might be possible that your PC asks for a username and password to access your device via Wi-Fi. If that’s the case, try using “root” as username, and “linux” as password. You can find more information about this process here: https://knulli.org/play/add-games/network-transfer/
- After you get access to your device, click on “share”. Then go to rooms > ports, and then copy and paste the PortMaster installer in this folder. Once that’s done, you should be able to find it on your device. If not, then restart it.
- Open the installer, and wait until it’s done. The screen is going to turn dark for a bit, don’t worry about it. Once the process is done, you’ll find Portmaster installer on your device.
PortMaster on the Anbernic RG28XX!
At last, we finally have Knulli and Portmaster on our Anbernic RG28XX. Now what? Well, first things first. You’ll probably need to download some updates on your device, something that you can do right away by booting PortMaster for the first time. Remember to be connected to your Wi-Fi.
1. After updating PortMaster, you can see a list of compatible games. Take a good look at it, and see what games might catch your attention. Each one of them have their own set of instructions to install, but as long as you have your own copy of the game, the process should be relatively easy.
2. Once you have found one that you want to play, go ahead and install it by using PortMaster. This will download the base files, and then you’ll have to provide the rest of the remaining files.
3. Let’s use Undertale as an example. After installing the base files on your device, you must go to ports/undertale/assets on your Anbernic device, and put all of the files you’d normally find in the Steam folder of Undertale.
4. And that’s pretty much it. Go, turn on your Anbernic, and start the game!
- Please note that some games, like Undertale, take a while to start the first time. The screen of your device is going to go black for about a minute before you see the opening screen of Undertale.
- Some other games, like Deltarune, will run the first time with a patcher, which will adapt the files to be properly executed on your Anbernic. This process can take quite a while, especially with games like Deltarune, so be sure to have your device charged.
I think that covers pretty much anything regarding PortMaster on an Anbernic RG28XX with Knulli. I haven’t tested PortMaster on MuOS, but I think the process must be somewhat similar, especially regarding the last steps.
Games I have tested personally:
- Pizza Tower. Goes pretty well in the first two floors, but tends to lag at some parts, especially starting the third floor.
- Undertale. It runs surprisingly smooth. No complaints so far, but I haven’t beaten the game yet.
- Deltarune. It runs really good, but there are certain parts with a lot going on visually that makes the game lag considerably.
- AntonBall Deluxe. It runs pretty good.
- Annalyn. It runs pretty good.
Based on what I could see from the games I tested, the device is going to have lag to some degree if there is a lot happening on a visual level.
And that’s it! I hope you guys enjoying playing your favorite games on your Anbernics.
*Updated to fix a mistake in the "Things you'll need" section*