Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you. Learn more.
PortMaster is one of the best things to happen to retro handhelds, and a lot of people have never heard of it. Instead of emulating old consoles, PortMaster runs games built to run natively on your handheld. That means real ports of indie hits and open-source remakes of classics, running smoothly on hardware they were never originally made for. Best of all, it is free, community-driven, and completely legal.
This guide explains what PortMaster is, how to install it, and which games to try first. We frame all of this around legal ports and games you own.
Affiliate disclosure: This page contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you.
What Is PortMaster?
PortMaster is a tool and a community library that installs game ports onto your handheld. A port takes a game's code and adapts it to run natively on your device's hardware, no emulation involved.
There are two kinds of ports you will see.
- Free and open-source ports. These are fully playable on their own. Open-source game engines and remakes like fan-made versions of classic titles fall here. Just install and play.
- Ports that need your own game files. Some ports are just the engine. To play, you copy in the data files from a copy of the game you legally own, often from a Steam or store purchase. The engine is free, but the game data must be yours.
PortMaster never includes pirated content. The whole project is built around legal ports and your own purchased games.
What You Need
- A supported handheld. PortMaster works best on Linux handhelds running firmware like KNULLI, muOS, ROCKNIX, ArkOS, and AmberELEC. It also has support on some Android devices.
- An internet connection on the device, since PortMaster downloads ports directly.
- For some ports, the game files from a copy you own.
PortMaster is light, so even budget handhelds can run many ports. The heavier 3D ports want a more capable device.
How to Install PortMaster
The exact steps depend on your firmware, but the flow is similar everywhere.
- Check if it is already installed. Many popular firmwares ship with PortMaster built in. Look through your apps or tools menu first.
- Install it if needed. If your firmware does not include it, download the PortMaster installer from the official source and follow the instructions for your firmware.
- Connect to WiFi. PortMaster needs to be online to browse and download ports.
- Open PortMaster from your apps or tools menu.
Our KNULLI setup guide and muOS setup guide cover getting those firmwares running first.
How to Install Games
Inside PortMaster, the process is simple.
- Browse the list of available ports. You can filter by what runs well on your device.
- Select a port and choose to install it. PortMaster downloads everything it needs.
- For a port that needs game data, it will tell you which files to add and where to put them. Copy in the files from your own copy of the game.
- Launch the port from your ports folder or games menu like any other game.
PortMaster handles the technical setup for you. You mostly just pick a game and play.
Best Ports to Start With
These are great first ports that show what PortMaster can do. Availability and performance vary by device, so check the compatibility notes in the app.
- Open-source remakes of classic strategy and RPG engines. Many beloved older PC games have free, fan-built engine remakes that run beautifully on a handheld.
- Indie platformers and action games that were released for Linux or had source code released. These run natively and feel great.
- Point-and-click adventure engines that load the data from games you own.
- Doom-engine and Build-engine games, where the open engines run anywhere and you supply your own game data for the commercial ones.
The PortMaster library grows constantly, so browse the in-app list to see what is new and what runs best on your handheld.
Why PortMaster Is Worth It
PortMaster fills a gap that emulation cannot. Instead of running a 30-year-old console in a box, you are running a game built to use your handheld's actual hardware. Ports often run smoother, look sharper, and add quality-of-life features the originals never had. It is one of the most rewarding things you can add to a Linux handheld, and it costs nothing.
Recommended Handhelds for PortMaster
PortMaster runs on most Linux handhelds. These are great picks.
The
handles plenty of 2D ports on a budget. For heavier 3D ports, the gives you more room. Want the most headroom for the demanding ports? The runs the whole library with ease.Related Guides
Related reading
GuideGuideGuide