From 880ec5bc6d55b4b246d0f9fcff160ea803fb47b4 Mon Sep 17 00:00:00 2001
From: PickleRick <davidecavagnola@gmail.com>
Date: Mon, 21 Sep 2026 12:38:13 +0200
Subject: [PATCH] Save uncommitted changes

---
 README.md                 |  9 +++++++++
 docs/integration-guide.md |  3 +++
 install.sh                | 16 ++++++++++++++++
 3 files changed, 28 insertions(+)

diff --git a/README.md b/README.md
index b4f0010..4bb2df3 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,15 @@ mkdir -p "${DEST}"
 curl -fsSL "${BASE}/LocalFlowPlugins/${CATEGORY}/${PLUGIN}/1.0.0/index.js" -o "${DEST}/index.js"
 ```
 
+The progress-enabled `copyToWorkDir/2.0.0` and `replaceOriginalFile/2.0.0`
+plugins also require this shared helper:
+
+```bash
+mkdir -p /path/to/tdarr/plugins/FlowPlugins/FlowHelpers/1.0.0
+curl -fsSL "${BASE}/FlowHelpers/1.0.0/copyWithProgress.js" \
+  -o /path/to/tdarr/plugins/FlowHelpers/1.0.0/copyWithProgress.js
+```
+
 | Plugin | Category |
 |---|---|
 | `mediaAnalyzerGOP` | `utility` |
diff --git a/docs/integration-guide.md b/docs/integration-guide.md
index c6a62dd..981020b 100644
--- a/docs/integration-guide.md
+++ b/docs/integration-guide.md
@@ -121,6 +121,9 @@ Aggiungi al PATH di sistema:
 `copyToWorkDir` 2.0.0 is optional but recommended when the source library is on
 a network share. Place it before the first analysis/transcode node; it records
 the library path for `replaceOriginalFile` 2.0.0.
+Both progress-enabled plugins require
+`FlowHelpers/1.0.0/copyWithProgress.js`; the installer downloads it
+automatically.
 
 ### 4.2 Connessioni nel Canvas
 
diff --git a/install.sh b/install.sh
index d51efd5..950fe65 100644
--- a/install.sh
+++ b/install.sh
@@ -86,6 +86,18 @@ download_plugin() {
   done
 }
 
+download_progress_helper() {
+  local dest="${PLUGIN_DIR}/FlowHelpers/1.0.0"
+  local url="${RAW}/FlowHelpers/1.0.0/copyWithProgress.js"
+  mkdir -p "$dest"
+  if curl -fsSL "$url" -o "${dest}/copyWithProgress.js"; then
+    echo "  ✓ copyWithProgress helper  →  ${dest}/copyWithProgress.js"
+  else
+    echo "  ✗ Failed to download copyWithProgress helper from ${url}"
+    return 1
+  fi
+}
+
 # ── Run ───────────────────────────────────────────────────────────────────────
 echo "=== Tdarr Plugin Updater ==="
 echo "    Source : ${GITEA_URL}/${GITEA_REPO} (branch: ${BRANCH})"
@@ -97,6 +109,10 @@ for plugin in "${TARGETS[@]}"; do
   download_plugin "$plugin" || ERRORS=$((ERRORS + 1))
 done
 
+if [[ $# -eq 0 || " ${TARGETS[*]} " == *" copyToWorkDir "* || " ${TARGETS[*]} " == *" replaceOriginalFile "* ]]; then
+  download_progress_helper || ERRORS=$((ERRORS + 1))
+fi
+
 echo ""
 if [[ $ERRORS -eq 0 ]]; then
   echo "✅ Done. Restart Tdarr server to pick up changes:"