A MinUI and NextUI Emu Pak for PortMaster which includes everything needed and requires no additional software.
MinUI PortMaster is an Emu Pak for MinUI and NextUI, wrapping up PortMaster, which organizes and simplifies the installation process for hundreds of PC ports. MinUI PortMaster is a standalone Emu Pak and does not require any additional software to run, for example, TRIMUI_EX. Everything is included in the download and only a few steps are needed to install.
Important
MinUI PortMaster has been designed to run on TrimUI devices only.
- Browse and install a wide selection of community ports and homebrew.
- Distributed as a single Pak folder, no additional setup required.
- Follows MinUI/NextUI SD card folder structure.
- View cover artwork in NextUI for installed ports.
- Supports deep sleep and shutdown on compatible devices.
PortMaster is designed and tested for the following platforms:
tg5040: Trimui Brick (formerlytg3040), Trimui Smart Pro
- Mount your MinUI SD card to your computer.
- Download the latest release from GitHub. It will be named
PORTS.pak.zip. - Copy the zip file to the correct platform folder in the "/Emus" folder on the SD card. Please ensure the new zip file name is
PORTS.pak.zip. - Extract the zip in place, then delete the zip file.
- Confirm that there is a
/Emus/<PLATFORM>/PORTS.pak/launch.shfile on your SD card. - Create a folder at
/Roms/Ports (PORTS). This is where all the ports data will be stored. - Create an empty file named
Portmaster.shin/Roms/Ports (PORTS). Alternatively, you can copy thePortmaster.shfile from this repository. - Eject your SD card and insert it back into your MinUI device.
Note: The <PLATFORM> folder name is based on the name of your device. For example, if you are using a TrimUI Brick, the folder is tg5040.
- From MinUI/NextUI, go to Ports and select the Portmaster entry to launch the Portmaster GUI.
- Browse available ports and install new ones.
- Installed ports will appear under the Ports entry in MinUI/NextUI.
Important
Not all ports are ready to run immediately after installation, and some may require additional steps. This usually involves copying files from a purchased copy of a game. The files will need to be copied to the corresponding port folder in /Roms/Ports (PORTS)/.ports on the SD card. Please refer to the port's documentation at the PortMaster website for specific instructions on how to install each port.
This is the recommended method for updating PortMaster to a new version. It keeps your PortMaster data and settings intact while updating everything else. It is the method used when updating the pak via the NextUI Pak Store.
- Mount your MinUI SD card to your computer.
- Download the latest release from GitHub. It will be named
PORTS.pak.zip. - Extract the zip file on your computer. This will create a new
PORTS.pakfolder. - In the new
PORTS.pakfolder, delete the folder namedPortMaster. - On your SD card, open the existing
/Emus/<PLATFORM>/PORTS.pakfolder. - Copy the entire contents of the new
PORTS.pakfolder (thePortMasterfolder will be missing) to the existingPORTS.pakfolder on your SD card. Overwrite any files when prompted. - Eject your SD card and insert it back into your MinUI device.
This method replaces the entire PORTS.pak folder on your SD card with a new one. It is quicker, but it's not recommended as PortMaster settings and data will be lost. This method is only recommended if you are having issues after trying the Safe Update method.
- Mount your MinUI SD card to your computer.
- Download the latest release from GitHub. It will be named
PORTS.pak.zip. - Delete the entire old
PORTS.pakfolder from/Emus/<PLATFORM>/on your SD card. - Copy the new
PORTS.pakfolder (from the extracted zip) to/Emus/<PLATFORM>/on your SD card. - Eject your SD card and insert it back into your MinUI device.
Important
This method may remove some dependencies required by your installed ports. If a port does not work after updating, launch PortMaster, go to Manage Ports, select the port that is not working, and choose Reinstall. This will restore any missing files for that port.
Deep sleep is supported on compatible devices. Click the power button to enter deep sleep. Click again to resume the game. To shut down, hold the power button for 2 seconds. Note: Shutdown does not save or resume the game, and any unsaved progress will be lost. For more information and issues, see MinUI Power Control.
Artwork for ports will automatically be displayed in NextUI. This feature can be disabled by creating a file named no-artwork in the /.userdata/<PLATFORM>/PORTS-portmaster folder on your SD card. MinUI is currently not supported.
- When you launch PortMaster or a port, a
/mnt/SDCARD/PortsTemp/portsfolder is created. It is usually deleted when PortMaster closes, but sometimes it may remain. You can safely delete thePortsTempfolder if PortMaster is not running and the/mnt/SDCARD/PortsTemp/portsfolder is empty. - Some loading screens can take a long time to complete, sometimes up to 10 minutes. This is most noticeable the first time you run PortMaster or a port, as files need to be unpacked and patched. Please be patient and allow the process to complete.
- To check which ports are currently working or have known issues with this pak, please visit the Ports Status wiki page.
- Log files are stored in
/.userdata/tg5040/logs/PORTS.txtfor debugging. - If you encounter issues, please open an issue on this GitHub repository with the details and a copy of the log file.
- The PortMaster team for all their hard work.
- ro8inmorgan, frysee and the rest of the NextUI contributors for developing NextUI.
- Shaun Inman for developing MinUI.
- Also, thank you, josegonzalez, for your pak repositories, which this project is based on.
PortMaster is open-source software licensed under the MIT License. See the LICENSE for details.
The libraries and binaries contained in the lib and bin directories are third-party components. They are licensed under their respective licenses and are not part of this project.
The MinUI PortMaster project code is licensed under the MIT License. See the project LICENSE file for more details.