1.4.8

Author: phantomptr

CHANGELOG.md

@@ -15,9 +15,12 @@ This project follows Semantic Versioning.
 - Logging for pre-create and resume scanning tuned to reduce noise while keeping progress visibility.
 - Connection controls are now managed automatically (no manual slider). Defaults: Payload 4, FTP 10; auto-tune adjusts based on file size/count.
 - Archive uploads now emit stall hints when progress pauses early.
+- RAR extraction now uses a single turbo mode (max speed) and the mode selector has been removed.
 
 ### Fixed
 - Archive extraction progress handler is now available across archive workflows.
+- Archive uploads now queue extraction (with temp cleanup) so extraction appears in the Extraction queue after upload finishes.
+- Queued extraction now runs in turbo mode consistently.
 
 ## [1.4.6] - 2026-02-04
 

FAQ.md

@@ -247,14 +247,19 @@ Stop retries automatically—no need to click multiple times.
 ## Archives & Extraction
 
 **Q: How does RAR extraction work?**  
-If **RAR Extract Mode** is enabled, the archive is uploaded to a temp folder and extracted on the PS5.  
+RAR extraction runs in a single turbo mode for maximum speed. The archive is uploaded to a temp folder and extracted on the PS5.  
 If **RAR Temp Storage** is set, the temp folder is `<selected storage>/ps5upload/tmp` (e.g. `/mnt/usb0/ps5upload/tmp`); otherwise it uses the destination’s storage root.  
 This requires a payload that supports the TMP override (older payloads will ignore the selection).
 
 **Q: Why keep failed RARs?**  
 Failed extractions keep the archive so you can **Requeue**.  
 Temp files are deleted only on **success** or **Clear tmp**.
 
+**Q: My archive upload looks stuck at the beginning. Is it frozen?**  
+Large archives may pause briefly before progress appears while the payload signals READY and the client primes the read pipeline.  
+If the source file is on a shared/network drive (for example `hgfs`), the first read can be slow.  
+Check the Transfer log for stall hints; they indicate whether the delay is from payload READY or source reads.
+
 ---
 
 ## Manage Tab (PS5 Browser)

README.md

@@ -143,7 +143,7 @@ Release bundle option:
     *   Pick a preset location (like `homebrew` or `etaHEN/games`).
     *   Give your folder a name.
 4.  **Upload:** Click **Upload** in the bottom right. The bar will track real-time progress.
-5.  **RAR uploads (optional):** If your source is a `.rar`, you can pick a **RAR Extract Mode** and (optionally) a **RAR Temp Storage** in Transfer settings to control where the archive is staged before extraction.
+5.  **RAR uploads (optional):** If your source is a `.rar`, extraction runs in a single turbo mode for maximum speed. You can still pick an optional **RAR Temp Storage** in Transfer settings to control where the archive is staged before extraction.
 
 ### 5. Manage Files (Optional)
 Open the **Manage** tab to browse your PS5's storage. You can rename, move, copy, delete, and `chmod 777` files or folders. You can also download files and folders from your PS5 to your computer (folder downloads run in a safe, sequential mode for stability). If something gets stuck, use **Reset UI** in Manage to recover.
@@ -187,6 +187,11 @@ Open the **FAQ** tab for built‑in help and troubleshooting (offline, bundled w
 **Q: "No writable storage found"?**
 *   The tool protects you from trying to write to read-only system partitions. If you want to use a USB drive, make sure it's formatted (exFAT is best) and plugged in *before* you load the payload.
 
+**Q: Archive upload shows 0% or looks stuck at the start?**
+*   Large archives can pause briefly while the payload reports READY and the client primes the read pipeline.
+*   If the source is on a shared/network drive (for example `hgfs`), the first read can be slow.
+*   The Transfer log now emits stall hints so you can see whether the delay is from payload READY or source reads.
+
 **Q: macOS: "App is damaged" or "Unidentified Developer"?**
 *   This is normal for unsigned apps. Right-click the app, select **Open**, and then click **Open** in the dialog.
 *   If macOS still blocks it, go to **System Settings -> Privacy & Security** and click **Open Anyway** for PS5 Upload.

app/server.js

@@ -1328,7 +1328,13 @@ async function precreateRemoteDirectories(ip, destRoot, files, options = {}) {
 
   const workers = Array.from({ length: PRECREATE_DIR_CONCURRENCY }, () => runWorker());
   await Promise.all(workers);
-  if (log) log(`Pre-create: done (${created} created, ${failed} failed).`);
+  if (log) {
+    if (failed > 0) {
+      log(`Pre-create: done (${created} created, ${failed} failed).`);
+    } else {
+      log(`Pre-create: done (${created} created).`);
+    }
+  }
   return { total, created, skipped: failed };
 }
 
@@ -1805,8 +1811,18 @@ async function payloadMaintenance(ip, port) {
   return true;
 }
 
-async function queueExtract(ip, port, src, dst) {
-  const response = await sendSimpleCommand(ip, port, `QUEUE_EXTRACT ${src}\t${dst}\n`);
+async function queueExtract(ip, port, src, dst, opts = {}) {
+  const cleanupPath = typeof opts.cleanupPath === 'string' ? opts.cleanupPath.trim() : '';
+  const deleteSource = opts.deleteSource === true;
+  const tokens = [src, dst];
+  if (cleanupPath || deleteSource) {
+    tokens.push(cleanupPath);
+    if (deleteSource) {
+      tokens.push('DEL');
+    }
+  }
+  const cmd = `QUEUE_EXTRACT ${tokens.join('\t')}\n`;
+  const response = await sendSimpleCommand(ip, port, cmd);
   if (!response.startsWith('OK ')) throw new Error(`Queue extract failed: ${response}`);
   return Number.parseInt(response.substring(3).trim(), 10);
 }
@@ -3048,14 +3064,14 @@ async function handleInvoke(cmd, args, runtime) {
             },
           });
         }
-        const queuedId = await queueExtract(ip, TRANSFER_PORT, remoteRarPath, destPath);
+        const queuedId = await queueExtract(ip, TRANSFER_PORT, remoteRarPath, destPath, { deleteSource: true });
         return { fileSize: stat.size, bytes: stat.size, files: 1, queuedId };
       }
 
       const ftpPort = await findFtpPort(ip, 'auto');
       if (!ftpPort) throw new Error('FTP not reachable on ports 1337/2121. Enable ftpsrv or etaHEN FTP service.');
       await uploadFilesViaFtpSimple(ip, ftpPort, remoteDir, [{ abs_path: rarPath, rel_path: path.basename(rarPath), size: stat.size }]);
-      const queuedId = await queueExtract(ip, TRANSFER_PORT, remoteRarPath, destPath);
+      const queuedId = await queueExtract(ip, TRANSFER_PORT, remoteRarPath, destPath, { deleteSource: true });
       return { fileSize: stat.size, bytes: stat.size, files: 1, queuedId };
     }