HarbourMaster

PortMaster Package Manager

This is the script backend that handles listing available ports, downloading and installing/uninstalling ports for our PortMaster GUI

• ports.md generation for PortMaster.sh
  • List by Genre
  • List by Updates
  • List by Ready to Run
  • Filter by device/capabilities
• Download Ports
• Install Ports
• List ports
• Detect ports installed by zip
  • Have a builtin list of known ports to figure out older ports and ports installed manually.
• Multiple Ports repositories
• Uninstall Ports

How it works:

port.json

Most of what harbourmaster uses is a file called <portname>.port.json , this contains all the information required for a port. Without this file, harbourmaster cannot properly add the port to PortMaster.

An example annotated json file is included . All ports must have a .port.json file and will be a requirement of submission to PortMaster.

We have an easy to use webpage for adding port.json file directly to your ports zip files, it all runs locally in your webbrowser so its easy to use.

Listing available ports:

Harbourmaster has a list of sources where it fetches ports from, by default it comes with:

With these two sources portmaster behaves as usual.

What makes portmaster different is it is now possible to install additional port sources, so that additional repositories of ports can be sourced.

Note : additional sources can be added, make a PR to get yours added

Installing ports:

Harbourmaster follows a specific process to identify and fetch the appropriate port for downloading.

Here's an overview of the steps involved:

• Port Identification: Ports are uniquely identified by their zip file names. Although this method may not be flawless, it has proven to be effective in practice.
• Source Priority: Harbourmaster fetches ports from the sources provided, considering their priority order. The tool retrieves ports from the sources in the specified sequence.
• Verification and Validation: Once a port is fetched from a source, Harbourmaster verifies its integrity. This involves checking if the downloaded port matches the supplied MD5 checksum. This verification ensures that the port is not corrupted or modified during the download process.
• Zip Content Check: After the download is validated, Harbourmaster inspects the contents of the zip file. It checks for the presence of at least one bash file and a data directory. Additionally, it scans for any unusual files that could potentially override core operating system files.
• Port Configuration: Harbourmaster ensures that a <portname>.port.json file exists for the port. This file contains relevant information about the port itself, which is combined with other data during the installation process to fully flesh it out.

By following this process, Harbourmaster reliably identifies, fetches, and verifies ports from the specified sources, ensuring the integrity and consistency of the downloaded files.

Keeping track of installed ports:

Harbourmaster keeps track of installed ports by examining the ports folder and reading the <portname>.port.json files associated with each port. These JSON files provide information about the specific files and directories related to each port.

During this process, Harbourmaster performs the following checks and actions:

• Detection of Broken Ports: Harbourmaster verifies the presence of the files and directories indicated in the <portname>.port.json files for each installed port. If any of these files or directories are not found, it indicates that the port is broken or incomplete.
• Identification of Unclaimed Files: Harbourmaster scans the files and directories within the ports folder to identify any files that have not been associated with a known port. These unclaimed files are then processed further.
• Detection of Newly Installed Ports: Among the unclaimed files, Harbourmaster compares them against its database of known ports. If a match is found, indicating that a new port has been installed, Harbourmaster flags it as such.
• Creation of <portname>.port.json File: For newly installed ports, Harbourmaster creates a corresponding <portname>.port.json file. This file contains the necessary information about the port, enabling Harbourmaster to manage and track it effectively.
• Validation of Newly Found Ports: While processing newly found ports, Harbourmaster checks all associated files and directories. If any of these files or directories are missing, it identifies the port as broken or incomplete.

By performing these checks and actions, Harbourmaster maintains an accurate record of installed ports, identifies broken ports, detects newly installed ports, and ensures the integrity of the associated files and directories. This also allows Harbourmaster to work with ports that are manually unzipped into the ports folder.

Known Ports:

Some ports, because of their nature, cannot or do not exist on PortMaster. So that harbourmaster can work as intended, we create a .port.json for them in the known-ports directory. Please create a PR for any that you come across that we don't know about.

Commands available:

Python libraries used:

• ansimarkup
• certifi
• colorama
• fastjsonschema
• idna
• loguru
• port_gui - used as pySDL2gui
• pypng
• pyqrcode
• PySDL2
• requests
• typing-extensions
• urllib3