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).