schmeeve
32859a5df0
rename-ai-snaps is rename-only again (+--include-renamed, +--only-generic); extract-ai-meta is the shared recursive metadata engine emitting canonical model/lora dest paths; organize-images does all sorting, gains --resort for idempotent tree re-sorts (used to fix ~10K old-scheme folders on the NAS).
518 lines
17 KiB
Python
Executable File
518 lines
17 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""
|
|
rename-ai-snaps — Scan PNGs for AI prompt metadata and rename descriptively.
|
|
|
|
Usage:
|
|
./rename-ai-snaps [path] [options]
|
|
|
|
Scans for ComfyUI PNGs, reads embedded prompt metadata, extracts keywords,
|
|
and renames files IN PLACE to:
|
|
schmeeve-AI-{keywords}.png
|
|
|
|
Renaming only — use organize-images to sort files into model/lora folders.
|
|
"""
|
|
|
|
import json
|
|
import os
|
|
import re
|
|
import sys
|
|
import time
|
|
from pathlib import Path
|
|
|
|
try:
|
|
from PIL import Image
|
|
except ImportError:
|
|
print("Error: Pillow (PIL) is required. Install with: pip install Pillow")
|
|
sys.exit(1)
|
|
|
|
# ── stopwords and filter sets ──────────────────────────────────────────────
|
|
|
|
QUALITY_TAGS = {
|
|
"score_6_up", "score_7_up", "score_8_up", "score_9",
|
|
"score_6", "score_7", "score_8",
|
|
"masterpiece", "best quality", "good quality", "normal quality",
|
|
"high quality", "highly detailed", "very detailed", "extreme detail",
|
|
"very_aesthetic", "absurdres", "8k", "4k",
|
|
"photorealistic", "photograph",
|
|
"depth of field", "solo focus", "cinematic",
|
|
"newest", "amazing", "stunning",
|
|
}
|
|
|
|
QUALITY_WORDS = {
|
|
"best", "good", "high", "top", "ultra", "super",
|
|
"mega", "hyper", "extreme", "extra", "ultimate",
|
|
}
|
|
|
|
TECHNICAL_WORDS = {
|
|
"detailed", "focus", "quality", "aesthetic", "realistic",
|
|
"cinematic", "lighting", "rendering", "shading", "texture",
|
|
"newest", "absurdres",
|
|
}
|
|
|
|
STOP_WORDS = {
|
|
"the", "a", "an", "of", "in", "on", "at", "to", "for", "with",
|
|
"and", "or", "is", "are", "was", "were", "be", "been", "being",
|
|
"have", "has", "had", "do", "does", "did", "will", "would",
|
|
"could", "should", "may", "might", "can", "shall", "this",
|
|
"that", "these", "those", "it", "its", "by", "from", "as",
|
|
"into", "through", "during", "before", "after", "above", "below",
|
|
"between", "out", "off", "over", "under", "again", "further",
|
|
"then", "once", "here", "there", "when", "where", "why", "how",
|
|
"all", "each", "every", "both", "few", "more", "most", "other",
|
|
"some", "such", "no", "nor", "not", "only", "own", "same", "so",
|
|
"than", "too", "very", "just", "about", "up", "down",
|
|
"make", "get", "set", "put", "take", "give", "show", "use",
|
|
"like", "look", "see", "want", "need", "let", "close", "full",
|
|
"add", "new", "one", "two", "five",
|
|
"also", "well", "back", "still", "even", "much",
|
|
"you", "your", "my", "me", "we", "our", "they", "them", "their",
|
|
}
|
|
|
|
GENERIC_WORDS = {
|
|
"man", "men", "guy", "guys", "boy", "boys", "woman", "women",
|
|
"girl", "girls", "people", "person", "human", "figure",
|
|
"photo", "image", "picture", "shot", "view", "pose", "posing",
|
|
"face", "head", "body", "skin", "hair", "eyes", "hand", "hands",
|
|
"dark", "light", "bright", "color", "colour",
|
|
}
|
|
|
|
NEGATIVE_INDICATORS = {
|
|
"deformed", "distorted", "disfigured", "poorly drawn", "bad anatomy",
|
|
"extra digits", "missing digits", "extra limbs", "missing limbs",
|
|
"ugly", "tiling", "low quality", "worst quality", "normal quality",
|
|
"lowres", "monochrome", "grayscale", "text", "watermark",
|
|
"branding", "border", "cropped", "signature", "username",
|
|
"error", "mutation", "mutated", "out of frame", "duplicate", "cloned",
|
|
"body out of frame", "bad hands", "bad face", "blurry",
|
|
}
|
|
|
|
# Generic ComfyUI output filenames (ComfyUI_00042_.png, ComfyUI_temp_….png)
|
|
GENERIC_RE = re.compile(r"^ComfyUI", re.IGNORECASE)
|
|
|
|
# ── Helpers ────────────────────────────────────────────────────────────────
|
|
|
|
def spinner():
|
|
chars = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
|
|
i = 0
|
|
while True:
|
|
yield chars[i % len(chars)]
|
|
i += 1
|
|
|
|
|
|
def is_negative_text(text):
|
|
lower = text.lower()
|
|
score = 0
|
|
for ind in NEGATIVE_INDICATORS:
|
|
if ind in lower:
|
|
score += 1
|
|
return score >= 2
|
|
|
|
|
|
def is_quality_only(text):
|
|
lower = text.lower()
|
|
words = re.findall(r"[a-z_]+", lower)
|
|
if not words:
|
|
return False
|
|
meaningful = sum(1 for w in words if w not in QUALITY_TAGS and len(w) > 2)
|
|
return meaningful == 0
|
|
|
|
|
|
# ── Metadata extraction from ComfyUI prompt JSON ───────────────────────────
|
|
|
|
def load_prompt_data(filepath):
|
|
"""Return parsed ComfyUI prompt JSON from a PNG, or None."""
|
|
try:
|
|
img = Image.open(filepath)
|
|
except Exception:
|
|
return None
|
|
|
|
if "prompt" not in img.info:
|
|
return None
|
|
|
|
try:
|
|
return json.loads(img.info["prompt"])
|
|
except (json.JSONDecodeError, TypeError):
|
|
return None
|
|
|
|
|
|
def extract_prompts(data):
|
|
"""Return (positive_prompt, negative_prompt) from parsed prompt JSON."""
|
|
# Gather all text fields from all nodes
|
|
candidates = []
|
|
for node in data.values():
|
|
inputs = node.get("inputs", {})
|
|
for field in ("text", "prompt", "positive", "negative", "value", "string"):
|
|
val = inputs.get(field, "")
|
|
if isinstance(val, str) and len(val.strip()) > 3:
|
|
candidates.append(val.strip())
|
|
|
|
# Second pass: resolve node references
|
|
for node in data.values():
|
|
inputs = node.get("inputs", {})
|
|
for field in ("text", "prompt", "positive", "negative", "value", "string"):
|
|
val = inputs.get(field)
|
|
if isinstance(val, list) and len(val) == 2 and isinstance(val[0], str):
|
|
ref_node = data.get(val[0], {})
|
|
ref_inputs = ref_node.get("inputs", {})
|
|
for rf in ("value", "text", "string"):
|
|
rv = ref_inputs.get(rf, "")
|
|
if isinstance(rv, str) and len(rv.strip()) > 3:
|
|
candidates.append(rv.strip())
|
|
break
|
|
|
|
if not candidates:
|
|
return None, None
|
|
|
|
positives = [c for c in candidates if not is_negative_text(c)]
|
|
negatives = [c for c in candidates if is_negative_text(c)]
|
|
|
|
positives = [c for c in positives if not is_quality_only(c)]
|
|
|
|
pos = max(positives, key=len) if positives else None
|
|
neg = max(negatives, key=len) if negatives else None
|
|
return pos, neg
|
|
|
|
|
|
def extract_all_candidates(text):
|
|
"""Extract all candidate keywords with position index for frequency scoring."""
|
|
if not text:
|
|
return []
|
|
|
|
text_lower = text.lower()
|
|
cleaned = re.sub(r"[\[\(\{][^\]\)\}]*[\]\)\}]", "", text_lower)
|
|
segments = re.split(r"[,.;:!?]+", cleaned)
|
|
|
|
seen = set()
|
|
candidates = []
|
|
position = 0
|
|
|
|
for seg in segments:
|
|
seg = seg.strip()
|
|
if not seg or len(seg) < 4:
|
|
continue
|
|
|
|
words = re.findall(r"[a-zA-Z_]+", seg)
|
|
good = []
|
|
for w in words:
|
|
wl = w.lower().strip("_")
|
|
if len(wl) < 3:
|
|
continue
|
|
if wl in STOP_WORDS or wl in GENERIC_WORDS:
|
|
continue
|
|
if wl in QUALITY_TAGS or wl in QUALITY_WORDS:
|
|
continue
|
|
if wl in TECHNICAL_WORDS:
|
|
continue
|
|
if wl in NEGATIVE_INDICATORS:
|
|
continue
|
|
if wl.startswith("score") or wl.startswith("step"):
|
|
continue
|
|
if wl.isdigit():
|
|
continue
|
|
good.append(wl)
|
|
|
|
if good:
|
|
taken = 0
|
|
for g in good:
|
|
if g not in seen and taken < 2:
|
|
candidates.append((g, position))
|
|
seen.add(g)
|
|
taken += 1
|
|
position += 1
|
|
|
|
return candidates
|
|
|
|
|
|
def select_best_keywords(candidates, freq_map, total_images, max_keywords=5):
|
|
if not candidates:
|
|
return []
|
|
|
|
if total_images <= 1:
|
|
return [kw for kw, _ in candidates[:max_keywords]]
|
|
|
|
scored = []
|
|
for kw, pos in candidates:
|
|
freq = freq_map.get(kw, 1)
|
|
rarity = 1.0 - ((freq - 1) / max(total_images - 1, 1))
|
|
max_pos = max(len(candidates), 1)
|
|
pos_bonus = (pos / max_pos) * 0.3
|
|
score = rarity + pos_bonus
|
|
scored.append((score, kw, pos))
|
|
|
|
scored.sort(key=lambda x: (-x[0], x[2]))
|
|
|
|
selected = []
|
|
seen = set()
|
|
for _, kw, _ in scored:
|
|
if kw not in seen:
|
|
selected.append(kw)
|
|
seen.add(kw)
|
|
if len(selected) >= max_keywords:
|
|
break
|
|
|
|
return selected
|
|
|
|
|
|
def keywords_to_name(keywords):
|
|
if not keywords:
|
|
return None
|
|
|
|
desc = "-".join(keywords)
|
|
desc = re.sub(r"[^a-z0-9-]", "-", desc)
|
|
desc = re.sub(r"-+", "-", desc).strip("-")
|
|
|
|
if len(desc) > 40:
|
|
desc = desc[:40].rstrip("-")
|
|
if "-" in desc:
|
|
truncated = "-".join(desc.split("-")[:-1])
|
|
if truncated and len(truncated) > 10:
|
|
desc = truncated
|
|
|
|
return f"schmeeve-AI-{desc}.png" if desc and len(desc) > 3 else None
|
|
|
|
|
|
# ── main ───────────────────────────────────────────────────────────────────
|
|
|
|
def main():
|
|
import argparse
|
|
|
|
parser = argparse.ArgumentParser(
|
|
description="Scan PNGs for AI prompt metadata and rename in place. "
|
|
"Does not move files — use organize-images for sorting.",
|
|
)
|
|
parser.add_argument(
|
|
"path", nargs="?", default=os.path.expanduser("~/Pictures"),
|
|
help="Directory to scan for PNG files (default: ~/Pictures)",
|
|
)
|
|
parser.add_argument(
|
|
"-n", "--no-interactive", action="store_true",
|
|
help="Auto-rename without prompting",
|
|
)
|
|
parser.add_argument(
|
|
"-r", "--recursive", action="store_true",
|
|
help="Search directories recursively (default: off)",
|
|
)
|
|
parser.add_argument(
|
|
"-p", "--preview", "--dry-run", action="store_true",
|
|
dest="dry_run",
|
|
help="Show proposed changes without making any",
|
|
)
|
|
parser.add_argument(
|
|
"--include-renamed", action="store_true",
|
|
help="Also process files already named schmeeve-AI-* (default: skip them)",
|
|
)
|
|
parser.add_argument(
|
|
"--only-generic", action="store_true",
|
|
help="Only rename generic ComfyUI_* filenames",
|
|
)
|
|
args = parser.parse_args()
|
|
|
|
scan_dir = Path(args.path).expanduser().resolve()
|
|
if not scan_dir.is_dir():
|
|
print(f"Error: {scan_dir} is not a directory")
|
|
sys.exit(1)
|
|
|
|
# Gather PNGs
|
|
glob_pattern = "**/*.png" if args.recursive else "*.png"
|
|
pngs = sorted(scan_dir.glob(glob_pattern))
|
|
|
|
if not pngs:
|
|
print(f" No PNG files found in {scan_dir}" +
|
|
(" (recursive search)" if args.recursive else ""))
|
|
return
|
|
|
|
# ── Phase 1: Collect candidates and build frequency map ──
|
|
sys.stdout.write(" Analyzing PNGs")
|
|
sys.stdout.flush()
|
|
spin = spinner()
|
|
image_data = {}
|
|
word_images = {}
|
|
for p in pngs:
|
|
sys.stdout.write(f"\r {next(spin)} Analyzing PNGs")
|
|
sys.stdout.flush()
|
|
# Skip already-renamed files (schmeeve-AI-*) unless requested
|
|
if not args.include_renamed and p.name.startswith("schmeeve-AI-"):
|
|
continue
|
|
if args.only_generic and not GENERIC_RE.match(p.name):
|
|
continue
|
|
data = load_prompt_data(str(p))
|
|
if not data:
|
|
continue
|
|
pos, neg = extract_prompts(data)
|
|
source = pos or neg
|
|
if source:
|
|
candidates = extract_all_candidates(source)
|
|
if candidates:
|
|
image_data[p] = candidates
|
|
for kw, _ in candidates:
|
|
if kw not in word_images:
|
|
word_images[kw] = set()
|
|
word_images[kw].add(p)
|
|
|
|
freq_map = {kw: len(images) for kw, images in word_images.items()}
|
|
total_images = len(image_data)
|
|
|
|
# ── Phase 1b: Propose new names (in place — same directory) ──
|
|
raw_proposals = {}
|
|
for p, candidates in image_data.items():
|
|
if total_images > 1:
|
|
keywords = select_best_keywords(candidates, freq_map, total_images)
|
|
else:
|
|
keywords = [kw for kw, _ in candidates[:5]]
|
|
name = keywords_to_name(keywords)
|
|
if not name or name == p.name:
|
|
continue
|
|
raw_proposals[p] = name
|
|
|
|
# Clear the spinner line
|
|
sys.stdout.write("\r" + " " * 60 + "\r")
|
|
sys.stdout.flush()
|
|
|
|
# Deduplicate file names within their directories
|
|
proposals = {}
|
|
used_paths = {}
|
|
for p, name in raw_proposals.items():
|
|
new_path = p.with_name(name)
|
|
key = str(new_path)
|
|
counter = 0
|
|
while key in used_paths:
|
|
counter += 1
|
|
ts = time.strftime("%m%d-%H%M%S", time.localtime(p.stat().st_mtime))
|
|
stem = new_path.stem
|
|
ext = new_path.suffix
|
|
new_path = new_path.with_name(f"{stem}-{ts}{'_' + str(counter) if counter > 1 else ''}{ext}")
|
|
key = str(new_path)
|
|
used_paths[key] = True
|
|
proposals[p] = new_path
|
|
|
|
# ── Phase 2: Display proposed changes ──
|
|
if not proposals:
|
|
print(" No renamable PNGs found.")
|
|
return
|
|
|
|
print(f"\n {'DRY RUN' if args.dry_run else 'PROPOSED'} — "
|
|
f"{len(proposals)} file(s) to rename in place\n")
|
|
|
|
for i, (old_path, new_path) in enumerate(proposals.items(), 1):
|
|
try:
|
|
src_display = str(old_path.relative_to(scan_dir))
|
|
except ValueError:
|
|
src_display = str(old_path)
|
|
if len(src_display) > 55:
|
|
src_display = src_display[:25] + "…" + src_display[-27:]
|
|
print(f" {i:>3}. {src_display}")
|
|
print(f" → {new_path.name}")
|
|
|
|
print()
|
|
|
|
if args.dry_run:
|
|
print(f" Dry-run complete. No files were changed.\n")
|
|
return
|
|
|
|
def do_rename(old_path, new_path):
|
|
"""Rename with collision suffix. Returns final path or None on failure."""
|
|
if old_path == new_path:
|
|
return new_path
|
|
if new_path.exists():
|
|
stem = new_path.stem
|
|
ext = new_path.suffix
|
|
counter = 1
|
|
while new_path.exists():
|
|
new_path = new_path.with_name(f"{stem}_{counter}{ext}")
|
|
counter += 1
|
|
print(f" (name existed, using {new_path.name})")
|
|
try:
|
|
old_path.rename(new_path)
|
|
return new_path
|
|
except (FileNotFoundError, OSError) as e:
|
|
print(f" SKIPPED ({e}): {old_path.name}")
|
|
return None
|
|
|
|
# ── Phase 3: Rename (interactive or auto) ──
|
|
if args.no_interactive:
|
|
renamed = 0
|
|
for old_path, new_path in proposals.items():
|
|
if do_rename(old_path, new_path):
|
|
renamed += 1
|
|
print(f" Renamed {renamed} file(s).")
|
|
else:
|
|
renamed = 0
|
|
skipped = 0
|
|
items = list(proposals.items())
|
|
i = 0
|
|
while i < len(items):
|
|
old_path, new_path = items[i]
|
|
|
|
print(f"\n [{i+1}/{len(items)}]")
|
|
print(f" From: {old_path.name}")
|
|
print(f" To: {new_path.name}")
|
|
remaining = len(items) - i - 1
|
|
rlabel = f"rename all {remaining}" if remaining else ""
|
|
sys.stdout.write(f" [Enter]=rename [e]=edit [s]=skip{' [a]=' + rlabel if rlabel else ''} [q]=quit: ")
|
|
sys.stdout.flush()
|
|
choice = sys.stdin.readline().strip().lower()
|
|
|
|
if choice == "q":
|
|
remaining = len(items) - i - 1
|
|
if remaining:
|
|
print(f" Skipping remaining {remaining} file(s).")
|
|
break
|
|
elif choice == "s":
|
|
skipped += 1
|
|
i += 1
|
|
continue
|
|
elif choice == "e":
|
|
sys.stdout.write(f" Edit keywords (name becomes 'schmeeve-AI-...'): ")
|
|
sys.stdout.flush()
|
|
custom = sys.stdin.readline().strip()
|
|
if custom:
|
|
custom_desc = re.sub(r"[^a-z0-9-]", "-", custom.lower())
|
|
custom_desc = re.sub(r"-+", "-", custom_desc).strip("-")
|
|
if custom_desc:
|
|
new_path = old_path.with_name(f"schmeeve-AI-{custom_desc}.png")
|
|
else:
|
|
print(" Invalid name, skipping.")
|
|
skipped += 1
|
|
i += 1
|
|
continue
|
|
else:
|
|
skipped += 1
|
|
i += 1
|
|
continue
|
|
elif choice == "":
|
|
pass
|
|
elif choice == "a":
|
|
for j in range(i, len(items)):
|
|
p, np = items[j]
|
|
if do_rename(p, np):
|
|
renamed += 1
|
|
break
|
|
else:
|
|
print(f" Unknown option '{choice}', skipping.")
|
|
skipped += 1
|
|
i += 1
|
|
continue
|
|
|
|
if do_rename(old_path, new_path):
|
|
renamed += 1
|
|
i += 1
|
|
|
|
print(f"\n Renamed: {renamed} Skipped: {skipped}")
|
|
|
|
# Check for JPEGs with AI metadata
|
|
jpg_pattern = "**/*.jpg" if args.recursive else "*.jpg"
|
|
remaining_ai = 0
|
|
for f in scan_dir.glob(jpg_pattern):
|
|
try:
|
|
img = Image.open(f)
|
|
if "prompt" in img.info:
|
|
remaining_ai += 1
|
|
except Exception:
|
|
pass
|
|
if remaining_ai:
|
|
print(f" Note: {remaining_ai} JPEG(s) with AI metadata found (not yet supported).")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|