About PortMaster
How a community project turned Linux handhelds into portable PC gaming machines.
PortMaster is a free, open-source application that lets you install and manage hundreds of PC game ports on Linux-based handheld gaming devices. If you own an Anbernic RG35XX, a PowKiddy RGB30, a TrimUI Smart Pro, or any of the 30+ supported handhelds, PortMaster gives you one-tap access to over 500 playable game ports — from indie favorites like Celeste and Stardew Valley to classics like Half-Life and Quake.
The app works as a package manager built specifically for the handheld gaming scene. Instead of hunting through forums for compatible builds and manually transferring files, PortMaster handles discovery, downloading, installation, and updates from a single interface that runs directly on your device.
The Story Behind PortMaster
From a shell script to the go-to tool for handheld gaming.
The Beginning
Christian Haitian (christianhaitian), already well-known in the handheld Linux community for ArkOS, started PortMaster as a simple bash script. The idea was straightforward: make it easy to install game ports on devices running custom Linux firmware. Early versions supported a handful of ports on a few devices.
Community Growth
As budget Linux handhelds exploded in popularity, PortMaster grew with them. The project moved to a community-driven model under the PortsMaster organization on GitHub. More porters joined. The game library expanded rapidly, and support broadened to include firmware like muOS, JelOS, AmberElec, and ROCKNIX.
The GUI Rewrite
The original bash-based interface was replaced with a proper GUI built on Python and SDL2. This brought cover art thumbnails, genre filtering, theme support, and a much smoother experience on small handheld screens. The app started feeling like a real storefront rather than a terminal utility.
500+ Ports and Growing
PortMaster now hosts over 500 game ports with support for 30+ handheld devices. The community includes dozens of active porters who regularly add new titles. Customizable themes, improved sorting, and better device detection make it the standard tool for anyone serious about handheld PC gaming on Linux.
What PortMaster Does
A package manager designed for handheld gamers.
One-Tap Installs
Browse the full library, pick a game, and install it directly on your device. No file transfers, no terminal commands, no manual setup.
Port Management
Update installed ports, remove ones you no longer play, and see which games are ready to run versus which need game files from your own library.
Smart Filtering
Sort by genre, porter, runtime, or just browse “Ready to Run” ports that work out of the box with no additional files needed.
Custom Themes
Eight built-in themes with dark and light variants. The interface adapts to your taste and looks right on every screen size.
Some ports are “Ready to Run” and work immediately. Others require you to supply your own game files (which you legally own). PortMaster clearly labels which is which.
The Team Behind It
Built by the community, for the community.
christianhaitian
The original creator of PortMaster and the developer behind ArkOS, one of the most popular custom firmware distributions for Linux handhelds. Christian built the first version of PortMaster to solve a real problem he saw in the community: getting game ports onto handheld devices was too complicated for most users.
PortsMaster Community
Today, PortMaster is maintained by the PortsMaster organization on GitHub. Dozens of contributors handle everything from porting individual games to maintaining the GUI, testing on new devices, and writing documentation. The project runs on volunteer effort and has no commercial backing — it exists because the handheld gaming community wanted it to.
PortMaster is released under the MIT license. The source code is publicly available on GitHub.
Why Users Rely on It
PortMaster changed what budget handhelds can do.
Before PortMaster, getting a PC game port running on a Linux handheld meant reading through forum threads, downloading files from scattered sources, fixing permissions, and hoping the build matched your firmware version. Most casual users never bothered.
PortMaster removed that friction entirely. Now, someone who just bought their first Anbernic device can have Stardew Valley, Cave Story, or Shovel Knight running within minutes of setting up their firmware. That accessibility turned Linux handhelds from retro emulation boxes into genuine multi-purpose gaming devices.
The community around PortMaster is active on Discord and Reddit, with porters regularly sharing progress on new titles and users helping each other troubleshoot device-specific issues. For many handheld owners, checking PortMaster for new ports has become a weekly habit.
About This Website
An independent resource for PortMaster users.
This website is a fan-made, independent informational resource. We are not affiliated with, endorsed by, or connected to the PortsMaster community, christianhaitian, or any official PortMaster development team.
We built this site to give PortMaster users a clean, organized place to find information about the software — what it does, how to set it up, which devices it supports, and where to get it. All download links point to the official PortMaster sources.
We do not host, modify, or redistribute PortMaster or any game files. We respect the developers and porters who make this project possible, and we encourage everyone to support them directly through their official website and GitHub repository.
Get in Touch
Questions, suggestions, or corrections? We want to hear from you.
Have feedback about this website or spotted something that needs fixing? Visit our Contact page.
For official PortMaster support, bug reports, and feature requests, head to the PortMaster GitHub repository or join the community on Discord.