Release v2.4.12 — fix GoldHEN/2121 directory listing (MLSD->LIST) + prefer port 2121

Root cause (found by testing against a live console): some PS5 FTP payloads (GoldHEN,
usually port 2121) advertise MLSD in FEAT but return an EMPTY MLSD listing for non-empty
dirs. basic-ftp trusted it and locked to MLSD, so every directory looked empty and 2121
scans found no games — even though plain LIST (what FileZilla uses) returns the contents.
Override useDefaultSettings to force ['LIST','LIST -a'] for all FTP clients.

Also: Find PS5 now scans/prefers 2121 before 1337 (PS5_PORTS + portPriority).

Verified live: 2121 root now lists 29 entries (was 0), /data/etaHEN/games shows the game,
1337 still works, and an end-to-end API scan over 2121 finds the installed title.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: NookieAI

CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to PS5 Vault are documented here.
 
 ---
 
+## [2.4.12] — 2026
+
+### Bug Fixes
+
+**Directories now read correctly on GoldHEN-style FTP (port 2121)**
+Some PS5 FTP payloads (notably GoldHEN, usually on port 2121) advertise MLSD in their
+feature list but return an *empty* MLSD listing for non-empty folders. The FTP library
+trusted that empty result and showed every directory as empty — so scanning over 2121
+found no games even though the files were right there (FileZilla, which uses the plain
+LIST command, showed them fine). PS5 Vault now always uses LIST, so 2121/GoldHEN consoles
+scan correctly. Verified live: a scan over port 2121 now finds the installed games.
+
+### Changes
+
+**Find PS5 now tries and prefers port 2121 before 1337.** Discovery scans
+2121, 1337, 1338, 21, 9090 (in that order) and, when more than one is a valid FTP server
+on the same console, prefers 2121.
+
+---
+
 ## [2.4.11] — 2026
 
 ### Bug Fixes

help.js

@@ -11,7 +11,13 @@
   <li><kbd>F1</kbd> opens this help at any time.</li>
 </ul>
 
-<h3>What's New (v2.4.11)</h3>
+<h3>What's New (v2.4.12)</h3>
+<ul>
+  <li><strong>GoldHEN / port 2121 fix</strong>: Consoles whose FTP runs on port 2121 (GoldHEN) now scan correctly. Previously their folders showed as empty because the payload's MLSD listing returns nothing — PS5 Vault now uses the plain LIST command, like FileZilla, so all your games are found.</li>
+  <li><strong>Find PS5 port order</strong>: Discovery now tries and prefers port 2121 before 1337 (then 1338, 21, 9090).</li>
+</ul>
+
+<h3>v2.4.11</h3>
 <ul>
   <li><strong>Verified release</strong>: This build passed an end-to-end test pass against a live PS5 — local and FTP scanning, local copy and FTP upload/download transfers, and the auto-updater all confirmed working. Also tightened the local developer API so a transfer of anything outside your scanned library is refused immediately.</li>
 </ul>

main.js

@@ -16,6 +16,20 @@ const { execFile } = require('child_process');
 const ftp = require('basic-ftp');
 const os = require('os');
 
+// ── PS5 FTP compatibility: force LIST instead of MLSD ─────────────────────────
+// Some PS5 FTP payloads (notably GoldHEN, commonly on port 2121) advertise MLST in
+// FEAT but return an EMPTY MLSD listing for non-empty directories. basic-ftp then
+// "succeeds" with 0 entries and locks to MLSD, so the app sees every directory as
+// empty even though a plain LIST returns the real contents (which is what FileZilla
+// uses). Override useDefaultSettings so every client uses LIST and never MLSD.
+{
+  const _useDefaultSettings = ftp.Client.prototype.useDefaultSettings;
+  ftp.Client.prototype.useDefaultSettings = async function () {
+    await _useDefaultSettings.call(this);
+    this.availableListCommands = ['LIST', 'LIST -a'];
+  };
+}
+
 const MAX_SCAN_DEPTH = 12;
 // Maximum concurrent dlClient connections during FTP scan.
 // PS5 FTP daemons (etaHEN/ftpsrv) support 3–4 simultaneous connections total.
@@ -3752,9 +3766,9 @@ ipcMain.handle('ps5-discover', async (_event, timeoutMs = 3000) => {
     }
   }
 
-  // Known PS5 homebrew FTP ports. 1337 (etaHEN/ftpsrv/John) and 2121 (GoldHEN) are
-  // the common ones and are tried/preferred first; the rest cover other payloads.
-  const PS5_PORTS = [1337, 2121, 1338, 21, 9090];
+  // Known PS5 homebrew FTP ports. 2121 (GoldHEN) and 1337 (etaHEN/ftpsrv/John) are the
+  // common ones and are tried/preferred first; the rest cover other payloads.
+  const PS5_PORTS = [2121, 1337, 1338, 21, 9090];
   const tcpHits = [];  // [{ip, port}] — raw TCP open
   // Per-probe timeout — generous enough for Wi-Fi PS5s (~200ms RTT + buffer).
   const perProbeTimeout = Math.max(800, Math.floor(timeoutMs / 4));
@@ -3827,7 +3841,7 @@ ipcMain.handle('ps5-discover', async (_event, timeoutMs = 3000) => {
   // while its real server runs on 1337. Deduping first (picking 2121) would verify
   // only 2121, get no banner, and discard the working 1337 — so the console was
   // never found even though it was right there.
-  const portPriority = { 1337: 0, 2121: 1, 1338: 2, 21: 3, 9090: 4 };
+  const portPriority = { 2121: 0, 1337: 1, 1338: 2, 21: 3, 9090: 4 };
   const verifiedAll = await Promise.all(
     tcpHits.map(async h => ({ ...h, ok: await verifyFtp(h.ip, h.port) }))
   );

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "ps5-vault",
-  "version": "2.4.11",
+  "version": "2.4.12",
   "description": "PS5 game library manager \u2014 scan, organise and transfer games via USB or FTP",
   "main": "main.js",
   "author": "PS5 Vault",