first commit

scan_and_prefix_pink.md

@@ -0,0 +1,30 @@
+Examples
+
+Basic (non-recursive):
+
+chmod +x scan_and_prefix_pink.sh
+./scan_and_prefix_pink.sh /path/to/videos
+
+
+Recursive + dry-run + custom prefix:
+
+./scan_and_prefix_pink.sh /path/to/videos --recursive --dry-run --prefix INTRO_
+
+
+Stricter detection (wider window, brighter requirement, higher ratio):
+
+./scan_and_prefix_pink.sh /path/to/videos \
+  --duration 1.2 --fps 6 --hue-min 280 --hue-max 335 \
+  --sat-min 0.40 --val-min 0.45 --min-ratio 0.7
+
+Notes
+
+Collision-safe: if the target name exists, the script appends .1, .2, … to the new filename.
+
+Idempotent: already-prefixed files are skipped.
+
+Output: one line per file with a clear status:
+
+RENAMED, NOT_MATCH, SKIPPED, or ERROR (with a short reason).
+
+You can tweak the HSV thresholds if your intro varies (e.g., broader hue band 270–340 or lower sat-min for paler pink).