Save uncommitted changes

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` |

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
 

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:"