Download PortMaster for Linux Handhelds

Yes, PortMaster is 100% safe to download. The project is fully open source under the MIT license, with all source code publicly available on GitHub at the PortsMaster/PortMaster-GUI repository. Every release is built from this transparent codebase, and the community regularly audits the code for security issues.

PortMaster version 2026.03.03 is about 23 MB (lightweight installer) or 633 MB (full installer with runtimes) and does not modify your handheld device’s core operating system libraries. Each game port bundles its own dependencies inside its port folder, keeping everything isolated from the rest of your system. The project was originally created by christianhaitian and is now maintained by the PortsMaster Community, a volunteer group of developers and porters with over 3,000 members on Discord.

• Source code is fully auditable on GitHub — no closed-source binaries
• Does not require root access or modify system-level files
• Each port runs in its own folder with self-contained libraries
• Over 500 ports have been tested across 30+ devices by the community
• No telemetry, ads, or data collection of any kind

Pro tip: Always download PortMaster from the official source at portmaster.games/installation.html. Third-party download sites may bundle outdated or modified versions that cause compatibility problems.

For more details on what PortMaster includes, check our features overview.

The official and safest download source for PortMaster is portmaster.games, maintained directly by the PortsMaster Community. You can also find releases on the official GitHub repository at PortsMaster/PortMaster-New. Both sources host the same verified PortMaster.zip file.

Many handheld gaming devices ship with a pre-installed version of PortMaster, but these bundled versions are often outdated. For example, the stock Linux OS on Anbernic RG353V devices included a broken version that would not self-update. The current version (2026.03.03) resolves those issues, but you need to manually replace the old installation with the latest download from the official site.

1. Visit our download section or go to portmaster.games/installation.html
2. Download the latest PortMaster.zip file (approximately 23 MB)
3. Transfer the zip to your device via SSH, SD card reader, or network share
4. Extract it to the correct folder for your firmware (typically /roms/ports/ for most CFW)
5. Launch PortMaster from the Ports section of your device menu

Pro tip: Bookmark the official installation page rather than searching each time. Several Reddit posts on r/RG353V and r/SBCGaming report users accidentally downloading fan-modified versions from unverified sources that caused boot issues.

See our Getting Started guide for a full installation walkthrough with device-specific instructions.

PortMaster supports over 30 Linux-based handheld gaming devices running compatible custom firmware. The full device list is maintained on portmaster.games and grows regularly as community members add support for new hardware.

The most popular supported devices include the Anbernic RG35XX series (RG35XX, RG35XX Plus, RG35XX H, RG35XX SP), Anbernic RG353 series (RG353V, RG353M, RG353P, RG353PS), Anbernic RG556, PowKiddy RGB30, TrimUI Smart Pro, TrimUI Brick, and the Miyoo Mini Plus. On the firmware side, PortMaster works with ArkOS, muOS, JELOS, ROCKNIX (formerly AmberELEC), Knulli, and several other Linux-based custom firmware options.

• Anbernic devices: RG35XX family, RG353 family, RG556, RG28XX
• PowKiddy devices: RGB30, RGB20S, and similar models
• TrimUI devices: Smart Pro, Brick, and compatible models
• Supported firmware: ArkOS, muOS, JELOS, ROCKNIX, Knulli, RetroOZ
• CPU architectures: ARM (RK3326, RK3566, RK3588, Allwinner H700)

Pro tip: Not all ports run on every device. Some graphically intensive ports like Stardew Valley need the newer RK3566 or RK3588 chipsets to run smoothly, while lighter ports like 2048 or Cave Story work on older RK3326 hardware.

Check the system requirements section for hardware specifics.

No, PortMaster does not work on Android-based handheld devices. It is built exclusively for Linux-based custom firmware systems. Devices like the Retroid Pocket 2S, Retroid Pocket 3+, and Retroid Pocket 4 Pro that run Android are not compatible with PortMaster.

PortMaster is written in Python with SDL2 and depends on the Linux filesystem structure and package layout that custom firmware provides. Android uses a completely different architecture, file system, and permissions model. The r/SBCGaming community has discussed this limitation extensively, and the PortsMaster developers have confirmed there are no plans for Android support given the fundamental platform differences.

• Compatible: Linux-based firmware — ArkOS, muOS, JELOS, ROCKNIX, Knulli
• Not compatible: Android, Windows, macOS, iOS, SteamOS
• Workaround for some devices: If your handheld supports dual-boot (like some Anbernic models), install a Linux CFW alongside Android and run PortMaster from the Linux side

If you own an Android-only device and want to play PC ports, your best options are using RetroArch with its libretro cores for certain engine ports (like PrBoom for Doom) or side-loading native Android builds of indie games when available.

Pro tip: Before buying a new handheld specifically for PortMaster, check the device compatibility list at portmaster.games. Some budget devices like the R36S clones are supported, but only if running a compatible Linux CFW like ArkOS.

Learn more about supported platforms on our features page.

PortMaster itself requires minimal resources — roughly 23 MB of storage and any ARM-based Linux handheld with a compatible custom firmware. The actual requirements depend heavily on which game ports you want to run.

The PortMaster application runs on devices with as little as 256 MB of RAM and an RK3326 processor (found in older handhelds like the Anbernic RG351). However, the more demanding game ports need stronger hardware. Stardew Valley, for example, runs best on RK3566 or newer chipsets with at least 1 GB of RAM. Lighter ports like Cave Story, AM2R, or 2048 will run on just about any supported device.

• PortMaster app: ~11 MB storage, ARM Linux, Python + SDL2 runtime
• Light ports (Cave Story, 2048): RK3326 / 256 MB RAM minimum
• Medium ports (Celeste, Half-Life): RK3566 / 512 MB RAM recommended
• Heavy ports (Stardew Valley, Balatro): RK3566+ / 1 GB RAM recommended
• Storage: Individual ports range from 5 MB to 500+ MB, plus game data files

WiFi connectivity is helpful for downloading ports directly on the device, but it is not required. You can sideload ports via SD card or the autoinstall folder method for devices without built-in WiFi.

Pro tip: Sort ports by “Ready to Run” in the PortMaster app to see which games do not need additional game files. These are free, open-source ports that work immediately after download.

See the full system requirements table for a device-by-device breakdown.

Yes, PortMaster is completely free. The application itself, all its code, and hundreds of the game ports it distributes cost nothing to download or use. There are no premium tiers, subscriptions, or paid features.

PortMaster is released under the MIT open-source license, which means anyone can use, modify, and redistribute the software without restrictions. The PortsMaster Community develops and maintains everything through volunteer effort. The project has been free since christianhaitian originally created it, and the current maintainers have stated they intend to keep it that way.

• PortMaster app: Free, open source, MIT license
• “Ready to Run” ports: Free to download and play immediately (200+ games)
• Ports requiring game files: You need to own the original game and supply the data files yourself (e.g., Stardew Valley requires your purchased game data folder)
• No ads or in-app purchases: The app contains zero monetization

The distinction between “Ready to Run” and other ports matters. Ready to Run ports include all necessary game files and are typically open-source games or fan recreations. Other ports need you to provide your own legally purchased game data files, which you copy to the appropriate folder on your device.

Pro tip: Filter by “Ready to Run” in the PortMaster app to browse the 200+ games you can play right now without needing any additional files. Great titles like AM2R, Cave Story, and Shovel Knight: Treasure Trove source port are in this category.

Visit our download section to get started at no cost.

It depends on the specific port. PortMaster offers two types of game ports: “Ready to Run” ports that include everything you need, and ports that require you to supply your own game data files from a purchased copy.

Around 200+ ports in the PortMaster library are labeled “Ready to Run,” meaning they bundle all necessary assets and can be played immediately after downloading. These are typically open-source game engines, fan recreations, or games whose developers have released them freely. The rest of the 500+ ports are engine ports — community-built Linux builds of game engines that need the original game data to function.

• Ready to Run (free): AM2R, Cave Story, Sonic the Hedgehog (decompilation), OpenLara (Tomb Raider), and 200+ more
• Requires game files: Stardew Valley, Celeste, Half-Life, Balatro, Shovel Knight
• Where to get game files: Purchase from Steam, GOG, Humble Bundle, or itch.io, then copy the data folder to the port directory on your SD card

The PortMaster app clearly labels which ports need game files and which are Ready to Run. When you select a port that needs files, it shows instructions explaining exactly which files to copy and where to place them on your device.

Pro tip: GOG versions of games often work better with PortMaster ports than Steam versions because GOG games ship DRM-free, making the data files easier to extract and transfer. Check the PortMaster Wiki for game-specific instructions.

Browse all available ports in our features section.

Installing PortMaster takes about five minutes. Download the latest PortMaster.zip from the official site, extract it to the correct folder on your SD card, and launch it from your device’s Ports menu.

The exact installation path varies by firmware. On ArkOS, the folder is /roms/tools/PortMaster/. On muOS, it is /roms/ports/. JELOS and ROCKNIX use /roms/ports/ as well. The PortMaster.zip file for version 2026.03.03 is approximately 23 MB, so it downloads quickly even on slow connections.

1. Download PortMaster.zip from our download section or portmaster.games/installation.html
2. Power off your handheld and remove the SD card (or connect via SSH/SFTP if you prefer)
3. Insert the SD card into your computer and navigate to the correct ports directory for your firmware
4. Delete any existing PortMaster folder in that directory to avoid conflicts with old versions
5. Extract the contents of PortMaster.zip into the ports directory
6. Safely eject the SD card, insert it back into your device, and power on
7. Navigate to the Ports section in your device menu and launch PortMaster
8. On first launch, PortMaster will auto-update itself and download the latest port database

Pro tip: If you see a “starting update” screen that seems stuck on first launch, give it 2-3 minutes. PortMaster is downloading metadata for all 500+ ports over your device’s WiFi, and handheld WiFi chips can be slow.

Our Getting Started guide has detailed walkthrough with firmware-specific screenshots.

You can install both PortMaster and individual game ports without WiFi by using the autoinstall folder method. This works by placing port zip files on your SD card, which PortMaster processes on next launch.

Some budget handhelds like the R36S clones and certain Miyoo Mini variants lack built-in WiFi, making direct downloads impossible. The PortsMaster community designed the offline installation workflow specifically for these devices. You download everything on your computer and transfer the files via SD card.

1. On your computer, download PortMaster.zip from portmaster.games and install it to the SD card as normal
2. For game ports, visit the PortMaster website and download individual port .zip files to your computer
3. On the SD card, navigate to /roms/ports/PortMaster/ and create a folder called “autoinstall” if it does not exist
4. Copy the downloaded port .zip files into the autoinstall folder (do not extract them)
5. Insert the SD card into your device and launch PortMaster
6. PortMaster will detect the files in autoinstall and process them automatically

The autoinstall method handles permissions and metadata the same way a WiFi download does. Your ports will appear in the Installed section and receive proper game covers and descriptions. If a port requires game data files (like Stardew Valley), you still need to copy those separately to the port’s game data directory.

Pro tip: You can batch-download multiple ports at once. Drop 10-20 .zip files into the autoinstall folder and PortMaster will process them all sequentially on next launch. Keep the .zip files intact — do not extract them into the autoinstall folder.

See our Getting Started guide for detailed offline setup instructions.

muOS and ArkOS have the best overall PortMaster compatibility, with ROCKNIX and Knulli close behind. The best choice depends on your specific handheld device and personal preference for UI and features.

Each custom firmware has slightly different strengths. muOS is popular on TrimUI devices and newer Anbernic models for its clean interface and strong PortMaster integration. ArkOS has been around longest and supports the widest range of devices, making it a safe default. ROCKNIX (the successor to AmberELEC) focuses on Rockchip-based devices and gets frequent updates. Knulli is a newer option that has gained traction for its multi-device support.

• muOS: Best for TrimUI Smart Pro, Brick. Clean UI, fast PortMaster updates
• ArkOS: Best all-rounder. Widest device support, mature and stable, large community
• ROCKNIX: Best for Anbernic RG353/RG556 with Rockchip SoCs. Regular updates, performance-focused
• Knulli: Good multi-device support, active development, growing community
• JELOS: Solid option but development has slowed; ROCKNIX forked from it

Regardless of which CFW you choose, PortMaster itself handles the abstraction layer between firmware versions. When you install or update PortMaster, it detects your firmware and configures paths and controls automatically.

Pro tip: Check r/SBCGaming on Reddit before choosing a CFW. Search your exact device model plus “best firmware” and you will find recent threads with real user recommendations and compatibility reports.

Read more about requirements in the system requirements section.

The most common cause of PortMaster crashes is running an outdated or corrupted installation. A clean reinstall of the latest version fixes the problem in roughly 90% of cases reported on r/SBCGaming and the PortMaster Discord.

This is especially common on devices that shipped with a pre-installed version of PortMaster. Anbernic handhelds running stock Linux firmware, R36S clones, and older PowKiddy devices often include PortMaster versions from 2023 that cannot self-update and crash on launch. The current release (2026.03.03) resolved many of these stability issues.

1. Back up your /roms/ports/ folder to preserve installed game data and saves
2. Delete the entire PortMaster folder from your ports directory
3. Download the latest PortMaster.zip from our download section
4. Extract the fresh installation to the same ports directory
5. Launch PortMaster — it will rebuild its database on first run
6. Selectively copy back your game data and save files from the backup

If PortMaster still crashes after a clean install, the issue may be firmware-related. Try updating your CFW to the latest version. ArkOS, muOS, and ROCKNIX all receive regular updates that improve PortMaster compatibility. You can also SSH into your device and run a port manually from the terminal (./GameName.sh from /roms/ports/) to see error output.

Pro tip: Keep a copy of PortMaster.zip on your SD card at all times. If something breaks after a firmware update, you can quickly reinstall without needing WiFi or a computer nearby.

See our Getting Started guide for detailed installation and recovery steps.

Control issues in PortMaster ports usually stem from firmware changes, incorrect device mapping, or an outdated PortMaster version. PortMaster handles controller mapping per-device, and problems typically appear after updating or reinstalling firmware.

Each custom firmware sends button events differently, and PortMaster maintains device-specific mapping profiles for all 30+ supported handhelds. When you update your CFW, the button mapping can shift. Similarly, some ports have their own internal control configurations that override PortMaster’s defaults. The community tracks these issues on GitHub and Discord, with fixes usually arriving within a few days of reports.

1. Update PortMaster to version 2026.03.03 or later — many mapping fixes were included
2. Check the PortMaster Options menu on your device for a “Controls” or “Gamepad” section and verify your device is correctly detected
3. For a specific port, check its documentation on the PortMaster Wiki — some ports have their own in-game control remapping (usually accessible via Start + Select)
4. If controls broke after a CFW update, reinstall PortMaster from scratch — the new install will detect the updated firmware and apply correct mappings

Some ports also have known control issues on certain devices. Half-Life and Quake ports, for instance, sometimes need manual sensitivity adjustments for analog sticks on RK3326-based handhelds. The PortMaster Wiki documents these per-port quirks with specific fixes.

Pro tip: If one port has broken controls but others work fine, the issue is port-specific rather than system-wide. Check the port’s page on portmaster.games for known issues and device-specific notes.

Learn about supported controls in the features section.

Firmware updates frequently break the existing PortMaster installation because they can change file paths, permissions, and system libraries. The fix is straightforward: reinstall PortMaster after every major firmware update.

This is one of the most commonly reported issues on r/RG353V, r/SBCGaming, and the PortMaster Discord. When ArkOS, muOS, or ROCKNIX push a new version, they sometimes restructure the /roms/ partition layout or update Python and SDL2 versions that PortMaster depends on. The old PortMaster binary can fail to launch because it references libraries or paths that no longer exist.

1. Before updating firmware, back up your entire /roms/ports/ folder to your computer
2. Update your CFW through its normal update process
3. After updating, delete the existing PortMaster folder from /roms/ports/ (or wherever your CFW places it)
4. Download the latest PortMaster.zip and install it fresh
5. Copy your backed-up game data and save files back into the appropriate port folders

Your game saves are stored inside each port’s folder (typically in a “gamedata” or “saves” subdirectory), so as long as you back up those specific folders, you will not lose progress. The PortMaster app itself does not store save data — each port manages its own files independently.

Pro tip: Join the PortMaster Discord (discord.gg/FDg86YtReQ) and check the announcements channel before applying any CFW updates. Community members often report compatibility issues within hours of a new firmware release, saving you troubleshooting time.

For step-by-step recovery instructions, read our Getting Started guide.

PortMaster auto-updates itself on launch when connected to WiFi. If your device has internet access, simply opening PortMaster will trigger an automatic version check and update to the latest release.

The current version is 2026.03.03, released in March 2026. When PortMaster detects a newer version, it downloads and applies the update before loading the main interface. You will see a “starting update” or “updating” message on screen during this process. The update typically takes 30-60 seconds depending on your WiFi speed. Individual game ports can also be updated by reinstalling them through the PortMaster app — the app preserves your save data when you reinstall a port.

1. Auto-update (WiFi): Just launch PortMaster. It checks for updates automatically on every start.
2. Manual update (no WiFi): Download the latest PortMaster.zip from portmaster.games on your computer, delete the old PortMaster folder on your SD card, and extract the new version in its place.
3. Updating individual ports: In the PortMaster app, go to Manage Ports, find the port with an available update, and select “Update.” Your saves are preserved.

If auto-update seems stuck or fails, your pre-installed version may be too old to auto-update. Versions from before mid-2024 had a known bug where the updater itself was broken. In that case, a manual reinstall is the only option.

Pro tip: The version number displays in the bottom corner of the PortMaster interface (shown as “PM 2026.03.03” or similar). Compare it against the latest release on portmaster.games to confirm you are running current software.

Get the latest version from our download section.

PortMaster version 2026.03.03 is the current release, featuring expanded device support, a refined user interface, and over 500 available game ports. The project passed the 500-port milestone in mid-2024, growing from 300 to 500 ports in just five months.

Recent updates have focused heavily on broadening hardware compatibility. TrimUI devices gained first-class support, and the Anbernic RG556 with its RK3588 chipset opened the door for more graphically demanding ports. The PortMaster GUI itself received performance improvements to reduce loading times on slower devices, and the theme system was expanded to include 8+ visual themes with both dark and light variants.

• 500+ game ports: Up from 300 in early 2024 — new ports added weekly by community porters
• muOS support: Full integration with muOS firmware for TrimUI devices
• Improved auto-update: More reliable self-updating mechanism, fixes the broken updater in pre-2024 versions
• New device support: TrimUI Smart Pro, Anbernic RG556, RG28XX, and additional R36S variants
• 8+ themes: Customizable visual themes including dark, light, and retro-styled options
• Better sorting and filtering: Sort by genre, porter, runtime; filter by Ready to Run

Pro tip: Follow the PortMaster GitHub repository (PortsMaster/PortMaster-GUI) and enable release notifications to get updates the day they ship. New port additions are announced on the Discord server first, often before they appear in the app.

Check our features section for a full breakdown of capabilities.

PortMaster and RetroArch serve different purposes and most handheld gamers use both. PortMaster runs native PC game ports, while RetroArch emulates classic console systems. They complement each other rather than compete directly.

RetroArch is a multi-system emulator frontend that uses libretro cores to run games from consoles like NES, SNES, Game Boy, PlayStation 1, N64, and more. It comes pre-installed on most custom firmware. PortMaster, on the other hand, runs native Linux builds of PC games — these are not emulated but compiled directly for ARM processors, which typically gives better performance and lower battery drain than emulation.

• PortMaster strength: Native PC ports (Stardew Valley, Celeste, Half-Life) run at full speed with proper controls
• RetroArch strength: Thousands of classic console ROMs across 40+ systems with save states, shaders, and rewind
• PortMaster limitation: Linux-only, 500+ ports, requires specific CFW
• RetroArch limitation: Emulation has overhead; some systems (N64, Dreamcast) struggle on weaker handhelds
• Overlap: A few games exist in both (Doom via PrBoom core vs PortMaster port), but the PortMaster version typically performs better

For retro console gaming (NES through PS1), RetroArch is the clear choice. For playing modern indie titles and PC ports on your handheld, PortMaster is unmatched. Install both — they coexist without conflict on all major custom firmware.

Pro tip: Some games available through RetroArch cores actually run better as PortMaster ports. Doom, Quake, and Tomb Raider all have PortMaster ports that offer smoother framerates and more control options than their RetroArch equivalents on ARM devices.

Explore what PortMaster offers in our features section.

You can install ports manually by extracting port zip files directly to your /roms/ports/ folder, but this is not recommended. The PortMaster app handles file permissions, metadata, and device-specific configuration that manual installs miss.

Manual installation was the original method before the PortMaster GUI existed, and some experienced users still prefer it for troubleshooting or testing unreleased ports. When you install manually, you skip the permission-setting and config-generation steps that the app performs, which can cause launch failures, missing controls, or broken save paths on certain firmware versions.

1. Download the port .zip file from the PortMaster website or GitHub
2. Extract it to /roms/ports/ on your SD card (the exact path depends on your CFW)
3. If the port requires game data files, copy them into the port’s gamedata subfolder
4. Set file permissions if needed: chmod +x /roms/ports/PortName/*.sh via SSH
5. The port should now appear in your device’s Ports menu

The main risk of manual installation is permissions. Linux requires the .sh launch scripts to be executable, and some SD card formats (FAT32) do not preserve Linux file permissions. If a port does not appear in your menu after manual install, SSH into your device and run chmod +x on the .sh files inside the port folder.

Pro tip: If you need to debug a port, SSH into your device and run the port’s .sh script directly from the terminal: cd /roms/ports/ && ./GameName.sh. This prints error output to the console, making it much easier to diagnose missing files or library issues.

For the recommended installation method, see our Getting Started guide.

PortMaster has over 500 game ports spanning every genre, but the community favorites consistently include Stardew Valley, Celeste, Half-Life, Balatro, AM2R, Cave Story, and Sonic Mania. These titles run well on most supported devices and showcase what native PC ports can do on handheld hardware.

The “best” ports depend on your device’s hardware and which games you already own. Budget handhelds with RK3326 chips can run lighter titles perfectly, while RK3566 and newer devices handle more demanding games. The PortMaster community on r/SBCGaming frequently posts “best of” lists and recommendations sorted by device capability.

• Ready to Run (no game files needed): AM2R, Cave Story, Sonic the Hedgehog 1+2 (decompilations), OpenLara (Tomb Raider), Super Mario 64 (decompilation), 2048, VVVVVV
• Requires game files (must own): Stardew Valley, Celeste, Half-Life, Balatro, Shovel Knight, Undertale, Sonic Mania
• FPS ports: Half-Life, Quake, Quake II, Doom (multiple source ports), Duke Nukem 3D
• RPG and adventure: Stardew Valley, Undertale, Hyper Light Drifter, CrossCode
• Platformers: Celeste, Sonic Mania, Freedom Planet, Shovel Knight

New ports are added weekly by volunteer porters. The PortMaster Discord announcements channel is the fastest way to learn about new additions. As of 2025, the library growth rate is approximately 10-15 new ports per month.

Pro tip: Sort the PortMaster app by “Most Downloaded” to see what the community plays most. Also check the “Recently Added” filter to discover fresh ports that may not be on the popular lists yet.

Download PortMaster and browse the full library from our download section.

Uninstalling PortMaster is simple — delete the PortMaster folder and all port folders from your /roms/ports/ directory. PortMaster does not install system-level components, so removing the folder removes the application entirely.

Since PortMaster keeps everything self-contained within the ports directory structure, there are no registry entries, system services, or hidden config files scattered across your device. Each game port similarly stores all its data inside its own subfolder. This clean architecture means uninstalling is just a folder deletion.

1. Power off your handheld and remove the SD card, or connect via SSH/SFTP
2. Navigate to /roms/ports/ (the exact path depends on your CFW)
3. Back up any game saves you want to keep — saves are inside each port’s folder (look for “gamedata” or “saves” subdirectories)
4. Delete the PortMaster folder to remove the application
5. Delete individual port folders (e.g., stardewvalley.zip folder) to remove specific games
6. If you want a clean slate, delete the entire /roms/ports/ content

After deletion, the Ports section on your device menu will simply show no entries. Your device firmware, emulators, and ROM collections are completely unaffected. If you decide to reinstall PortMaster later, it is a fresh start with no leftover config from the previous installation.

Pro tip: Before uninstalling, export your save files from ports you care about. Copy the gamedata folders to your computer. If you reinstall the same ports later, dropping those folders back restores your progress.

If you want to reinstall, visit our download section for the latest version.