From 778d6e51edb3ed2610b8d1d836f76136e9d74e6f Mon Sep 17 00:00:00 2001
From: PickleRick <davidecavagnola@gmail.com>
Date: Sat, 19 Sep 2026 14:03:56 +0200
Subject: [PATCH] fix: use Gitea git archive URLs in README (no release
 dependency)

---
 README.md | 76 ++++++++++++++++++++++++++++++++++++++++---------------
 1 file changed, 56 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index da10db2..bcec274 100644
--- a/README.md
+++ b/README.md
@@ -8,18 +8,23 @@ A collection of [Tdarr](https://tdarr.io/) Flow plugins for automated media tran
 
 ## ⚡ Quick Install via curl
 
+> **How it works**: Gitea serves a real ZIP of any branch at `/archive/<branch>.zip`.
+> This is a built-in git archive — **no release workflow required**, always up to date.
+
 ### Full Suite (all 7 plugins)
 
 ```bash
-# Replace vX.Y.Z with the desired release tag, or use "latest"
-VERSION=latest
 PLUGIN_DIR=/path/to/tdarr/plugins/FlowPlugins
 
-curl -L https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/releases/download/${VERSION}/Tdarr-plugins-${VERSION}.zip \
-  -o tdarr-plugins.zip
+# Download a live ZIP of the main branch directly from Gitea
+curl -fsSL https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/archive/main.zip \
+  -o /tmp/tdarr-plugins.zip
 
-unzip -o tdarr-plugins.zip -d "${PLUGIN_DIR}"
-rm tdarr-plugins.zip
+# Extract and copy into your plugin directory
+unzip -q -o /tmp/tdarr-plugins.zip -d /tmp/tdarr-extract
+cp -r /tmp/tdarr-extract/Tdarr-plugin/LocalFlowPlugins "${PLUGIN_DIR}/"
+cp -r /tmp/tdarr-extract/Tdarr-plugin/FlowHelpers     "${PLUGIN_DIR}/"
+rm -rf /tmp/tdarr-plugins.zip /tmp/tdarr-extract
 ```
 
 After extracting, restart the Tdarr server so it picks up the new plugins:
@@ -28,24 +33,55 @@ After extracting, restart the Tdarr server so it picks up the new plugins:
 docker restart tdarr-server
 ```
 
-### Individual Plugin
-
-Each plugin is also released as its own ZIP (e.g. `transcode2PassX265-latest.zip`):
+### One-liner (copy-paste for Docker hosts)
 
 ```bash
-PLUGIN=transcode2PassX265
-VERSION=latest
-DEST=/path/to/tdarr/plugins/FlowPlugins/LocalFlowPlugins/video/${PLUGIN}/1.0.0
-
-mkdir -p "${DEST}"
-curl -L https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/releases/download/${VERSION}/${PLUGIN}-${VERSION}.zip \
-  -o ${PLUGIN}.zip
-unzip -o ${PLUGIN}.zip -d "${DEST}"
-rm ${PLUGIN}.zip
+PLUGIN_DIR=/your/tdarr/plugins/FlowPlugins && \
+curl -fsSL https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/archive/main.zip -o /tmp/tp.zip && \
+unzip -q -o /tmp/tp.zip -d /tmp/tpx && \
+cp -r /tmp/tpx/Tdarr-plugin/LocalFlowPlugins "${PLUGIN_DIR}/" && \
+cp -r /tmp/tpx/Tdarr-plugin/FlowHelpers     "${PLUGIN_DIR}/" && \
+rm -rf /tmp/tp.zip /tmp/tpx && \
+docker restart tdarr-server && echo "Done."
 ```
 
-Available plugin names: `mediaAnalyzerGOP`, `setAnimationFlag`, `extractChaptersXml`,
-`audioSelectorClamping`, `backupSourceAudio`, `extractSubtitlesAndOcr`, `transcode2PassX265`
+### Individual Plugin (single raw file)
+
+Each plugin is a single `index.js` file. Download just what you need:
+
+```bash
+# Example: transcode2PassX265
+BASE=https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/raw/branch/main
+PLUGIN=transcode2PassX265
+CATEGORY=video
+DEST=/path/to/tdarr/plugins/FlowPlugins/LocalFlowPlugins/${CATEGORY}/${PLUGIN}/1.0.0
+
+mkdir -p "${DEST}"
+curl -fsSL "${BASE}/LocalFlowPlugins/${CATEGORY}/${PLUGIN}/1.0.0/index.js" \
+  -o "${DEST}/index.js"
+```
+
+| Plugin | Category | Path segment |
+|---|---|---|
+| `mediaAnalyzerGOP` | `utility` | `LocalFlowPlugins/utility/mediaAnalyzerGOP/1.0.0/index.js` |
+| `setAnimationFlag` | `utility` | `LocalFlowPlugins/utility/setAnimationFlag/1.0.0/index.js` |
+| `extractChaptersXml` | `utility` | `LocalFlowPlugins/utility/extractChaptersXml/1.0.0/index.js` |
+| `audioSelectorClamping` | `audio` | `LocalFlowPlugins/audio/audioSelectorClamping/1.0.0/index.js` |
+| `backupSourceAudio` | `audio` | `LocalFlowPlugins/audio/backupSourceAudio/1.0.0/index.js` |
+| `extractSubtitlesAndOcr` | `subtitles` | `LocalFlowPlugins/subtitles/extractSubtitlesAndOcr/1.0.0/index.js` |
+| `transcode2PassX265` | `video` | `LocalFlowPlugins/video/transcode2PassX265/1.0.0/index.js` |
+
+### Tagged Releases (optional, requires CI push)
+
+Once a release is published by the CI workflow, versioned ZIPs are also available:
+
+```bash
+VERSION=v1.0.1
+curl -L https://git.cdtech.freeddns.org/PickleRick/Tdarr-plugin/releases/download/${VERSION}/Tdarr-plugins-${VERSION}.zip \
+  -o tdarr-plugins.zip
+unzip -o tdarr-plugins.zip -d "${PLUGIN_DIR}"
+rm tdarr-plugins.zip
+```
 
 ---