Try a portmaster integration thing

Author: JeodC

.github/workflows/collect_ports.yml

@@ -48,7 +48,7 @@ jobs:
           mkdir -p temp_ports
           [ -f docs/ports.json ] || echo "[]" > docs/ports.json
 
-      # ────────────────────── DETERMINE PORTS ──────────────────────
+      # ---------------------- DETERMINE PORTS ----------------------
       - name: Determine ports to process
         id: ports
         run: |
@@ -149,7 +149,7 @@ jobs:
       # lifetime_downloads is only updated when a port is re-uploaded (Process ports step).
       # The frontend adds the live GitHub download_count on top for the current period.
 
-      # ────────────────────── PROCESS PORTS ──────────────────────
+      # ---------------------- PROCESS PORTS ----------------------
       - name: Process ports
         if: steps.ports.outputs.ports != ''
         run: |
@@ -266,7 +266,7 @@ jobs:
             mv "$PORTS_JSON.tmp" "$PORTS_JSON"
           done
 
-      # ────────────────────── SYNC DISK, JSON, AND RELEASE ──────────────────────
+      # ---------------------- SYNC DISK, JSON, AND RELEASE ----------------------
       - name: Purge deleted or invalid ports
         run: |
           set -euo pipefail
@@ -328,13 +328,17 @@ jobs:
 
             [[ "$ASSET_NAME" == *.zip ]] || continue
 
+            # images.zip belongs to the PortMaster catalog, not a port --
+            # leave it alone.
+            [[ "$ASSET_NAME" == "images.zip" ]] && continue
+
             if ! printf '%s\n' "${VALID_NAMES[@]}" | grep -iqx "$ASSET_NAME"; then
               echo "Deleting orphaned asset: $ASSET_NAME"
               gh api -X DELETE "repos/${GITHUB_REPOSITORY}/releases/assets/$ASSET_ID" || echo "Failed to delete $ASSET_NAME"
             fi
           done
 
-      # ────────────────────── RELEASE ──────────────────────
+      # ---------------------- RELEASE ----------------------
       - name: Ensure release exists
         run: |
           gh release view ports-latest >/dev/null 2>&1 || \
@@ -353,6 +357,36 @@ jobs:
             gh release upload ports-latest "$f" --clobber
           done
 
+      # ---------------------- PORTMASTER CATALOG ----------------------
+      # PortMasterV3 ports.json + images.zip (buildtools/generate_pm_catalog.py).
+      # Unchanged assets keep their ids -- Pharos caches images by asset id+size.
+      - name: Publish PortMaster catalog
+        run: |
+          set -euo pipefail
+          python3 buildtools/generate_pm_catalog.py --output temp_pm
+
+          # The images.zip md5 is baked into ports.json, so if the catalog
+          # didn't change, the images didn't either.
+          if curl -sfL -o current_catalog.json \
+              "https://github.com/${GITHUB_REPOSITORY}/releases/download/ports-latest/ports.json"; then
+            if cmp -s current_catalog.json temp_pm/ports.json; then
+              echo "PortMaster catalog unchanged; skipping upload."
+              exit 0
+            fi
+            OLD_MD5=$(jq -r '.utils["images.zip"].md5 // empty' current_catalog.json || true)
+            NEW_MD5=$(md5sum temp_pm/images.zip | awk '{print $1}')
+            if [[ -n "$OLD_MD5" && "$OLD_MD5" == "$NEW_MD5" ]]; then
+              echo "images.zip unchanged; uploading catalog only."
+              gh release upload ports-latest temp_pm/ports.json docs/030_rhh.source.json --clobber
+              exit 0
+            fi
+          fi
+          gh release upload ports-latest \
+            temp_pm/ports.json \
+            temp_pm/images.zip \
+            docs/030_rhh.source.json \
+            --clobber
+
       - name: Commit ports.json
         run: |
           git config user.name github-actions

.github/workflows/collect_screenshots.yml

@@ -25,6 +25,14 @@ If you use Pharos, autoinstall is performed for you.
 
 You should use the **BETA** branch of the PortMaster application to ensure you have all the included tools (e.g. 7zzs).
 
+### Adding this repository to the PortMaster app
+PortMaster's own app can browse and install these ports directly. Download [030_rhh.source.json](https://github.com/JeodC/RHH-Ports/releases/download/ports-latest/030_rhh.source.json) and place it in the `config` folder inside your PortMaster installation (next to `020_portmaster.source.json`), commonly:
+
+- `/roms/ports/PortMaster/config/` (ArkOS and similar)
+- `.local/share/PortMaster/config/` (ROCKNIX, muOS, Knulli, and similar)
+
+On the next launch PortMaster will fetch this repository's catalog alongside its own. Note that a handful of ports here share names with entries in the official PortMaster or Multiverse catalogs; for those, PortMaster shows the official entry instead of mine.
+
 ## Port Capability Requirements
 Some of the ports in this repository have minimum requirements. Be sure to check the `port.json` file for a port to see if it lists any of the following requirements: