assets-metadata-remover 1.0.0__tar.gz

assets_metadata_remover-1.0.0/.agents/kyro/kyro.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [],
+  "activeScope": null,
+  "runtimeVersion": "3.2.2",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": [
+    {
+      "agent": "standard",
+      "scope": "workspace",
+      "installedAt": "2026-06-14T03:55:56.047Z",
+      "corePath": "~/.agents/kyro/current",
+      "commandsPath": "~/.agents/skills",
+      "skillsPath": "~/.agents/skills"
+    }
+  ]
+}

assets_metadata_remover-1.0.0/.atl/.skill-registry.cache.json

@@ -0,0 +1,3 @@
+{
+  "fingerprint": "94ceafe945dfb48cc542321ba1ed811b601f9fe5"
+}

assets_metadata_remover-1.0.0/.atl/skill-registry.md

@@ -0,0 +1,74 @@
+# Skill Registry — metadata-remover
+
+<!-- Auto-generated by gentle-ai skill-registry refresh. Run `gentle-ai skill-registry refresh --force` to regenerate. -->
+
+Last updated: 2026-06-14
+
+## Sources scanned
+
+- /Users/rperaza/.agents/skills
+- /Users/rperaza/.config/opencode/skills
+- /Users/rperaza/.claude/skills
+- /Users/rperaza/.gemini/skills
+- /Users/rperaza/.gemini/antigravity/skills
+- /Users/rperaza/.cursor/skills
+- /Users/rperaza/.copilot/skills
+- /Users/rperaza/.codex/skills
+- /Users/rperaza/.codeium/windsurf/skills
+- /Users/rperaza/.qwen/skills
+- /Users/rperaza/.kiro/skills
+
+## Contract
+
+**Delegator use only.** This registry is an index, not a summary. Any agent that launches subagents reads it to select relevant skills, then passes exact `SKILL.md` paths for the subagent to read before work.
+
+`SKILL.md` remains the source of truth. Do not inject generated summaries or compact rules by default; pass paths so subagents load the full runtime contract and preserve author intent.
+
+## Skills
+
+| Skill | Trigger / description | Scope | Path |
+| --- | --- | --- | --- |
+| `branch-pr` | Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review. | user | `/Users/rperaza/.config/opencode/skills/branch-pr/SKILL.md` |
+| `chained-pr` | Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus. | user | `/Users/rperaza/.config/opencode/skills/chained-pr/SKILL.md` |
+| `clean-ddd-hexagonal` | Proactively apply when designing APIs, microservices, or scalable backend structure. Triggers on DDD, Clean Architecture, Hexagonal, ports and adapters, entities, value objects, domain events, CQRS, event sourcing, repository pattern, use cases, onion architecture, outbox pattern, aggregate root, anti-corruption layer. Use when working with domain models, aggregates, repositories, or bounded contexts. Clean Architecture + DDD + Hexagonal patterns for backend services, language-agnostic (Go, Rust, Python, TypeScript, Java, C#). | user | `/Users/rperaza/.agents/skills/clean-ddd-hexagonal/SKILL.md` |
+| `code-analyzer` | Analyzes code modules and generates structured technical reports with architecture diagrams. Trigger: When the user asks to analyze, explain, or document a module, file, or codebase section. | user | `/Users/rperaza/.agents/skills/code-analyzer/SKILL.md` |
+| `cognitive-doc-design` | Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs. | user | `/Users/rperaza/.config/opencode/skills/cognitive-doc-design/SKILL.md` |
+| `comment-writer` | Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments. | user | `/Users/rperaza/.config/opencode/skills/comment-writer/SKILL.md` |
+| `dead-code-auditor` | Rigorous dead code audit for any module, folder, or file in any programming language. Detects orphan files never imported anywhere, classes/functions/ methods declared but never called, constructor parameters received but never consumed, unused imports/requires, private fields with no references, and commented-out code blocks.  Use this skill whenever the user asks to: review unused code, clean up a feature after a refactor, find dead code, detect orphan files or classes, audit what can be deleted, find what's left over after a big change, or any variation of "what's not being used / what can I remove". Also triggers when the user says they made large changes and wants to know what became obsolete.  IMPORTANT: This skill only reports — it never deletes anything. At the end it always offers to generate a removal plan with /plan. | user | `/Users/rperaza/.agents/skills/dead-code-auditor/SKILL.md` |
+| `file-search` | Use when working with ANY codebase search — text patterns, structural/AST code search, finding files by name, searching non-code files (PDFs, archives), or analyzing codebase size and language breakdown. | user | `/Users/rperaza/.agents/skills/file-search/SKILL.md` |
+| `find-skills` | Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill. | user | `/Users/rperaza/.agents/skills/find-skills/SKILL.md` |
+| `go-testing` | Trigger: Go tests, go test coverage, Bubbletea teatest, golden files. Apply focused Go testing patterns. | user | `/Users/rperaza/.config/opencode/skills/go-testing/SKILL.md` |
+| `golang-pro` | Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration, CLI tools, benchmarks, or table-driven testing. | user | `/Users/rperaza/.agents/skills/golang-pro/SKILL.md` |
+| `growth-architect` | AI Co-Founder & Growth Architect: strategic clarity, product vision, MVP design, and architecture decisions (ADRs) before execution begins. Trigger: When user needs strategic advice, MVP validation, market analysis, product vision, or architecture decisions — before generating any execution plan. | user | `/Users/rperaza/.agents/skills/growth-architect/SKILL.md` |
+| `growth-ceo` | Elite tech CEO strategist that thinks like Musk, Bezos, Altman, Huang, and Thiel combined. Generates billion-dollar-scale strategic initiatives, product visions, and growth plays using first principles, 7 Powers, flywheels, and exponential thinking. Use this skill whenever the user discusses product strategy, business decisions, growth challenges, competitive positioning, or asks "what should we build" — even if they don't explicitly ask for "strategy". This includes: scaling from N to 10N users, what to build vs NOT build, MVP decisions, feature prioritization, competitive differentiation, enterprise vs self-serve, go-to-market, pivoting, revenue strategy, reducing churn, positioning against competitors, fundraising strategy, team building, platform plays, or any question where the user needs a founder/CEO-level perspective. If the user describes their product and asks "what should I do" — use this skill. Think big. Resources can be acquired. The vision comes first. | user | `/Users/rperaza/.agents/skills/growth-ceo/SKILL.md` |
+| `hatch-pet` | Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly. | user | `/Users/rperaza/.codex/skills/hatch-pet/SKILL.md` |
+| `imagegen` | Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas. | user | `/Users/rperaza/.codex/skills/.system/imagegen/SKILL.md` |
+| `issue-creation` | Create Gentle AI issues with issue-first checks. Trigger: creating GitHub issues, bug reports, or feature requests. | user | `/Users/rperaza/.config/opencode/skills/issue-creation/SKILL.md` |
+| `judgment-day` | Trigger: judgment day, dual review, adversarial review, juzgar. Run blind dual review, fix confirmed issues, then re-judge. | user | `/Users/rperaza/.config/opencode/skills/judgment-day/SKILL.md` |
+| `kyro-forge` | Run the Kyro forge workflow through the installed workspace harness | user | `/Users/rperaza/.agents/skills/kyro-forge/SKILL.md` |
+| `kyro-status` | Show Kyro project status through the installed workspace harness | user | `/Users/rperaza/.agents/skills/kyro-status/SKILL.md` |
+| `kyro-wrap-up` | Close the Kyro session through the installed workspace harness | user | `/Users/rperaza/.agents/skills/kyro-wrap-up/SKILL.md` |
+| `microservices-patterns` | Design microservices architectures with service boundaries, event-driven communication, and resilience patterns. Use when building distributed systems, decomposing monoliths, or implementing microservices. | user | `/Users/rperaza/.agents/skills/microservices-patterns/SKILL.md` |
+| `migrate-to-codex` | Migrate supported instruction files, skills, agents, and MCP config into Codex project and global files. | user | `/Users/rperaza/.codex/skills/migrate-to-codex/SKILL.md` |
+| `obsidian` | Unified Obsidian vault operations: sync documents to vault, read notes for context, search knowledge, and validate markdown standards. Filesystem-based, no MCP required. Trigger: When user wants to read from or write to Obsidian vault. | user | `/Users/rperaza/.agents/skills/obsidian/SKILL.md` |
+| `openai-docs` | Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing to official OpenAI domains. | user | `/Users/rperaza/.codex/skills/.system/openai-docs/SKILL.md` |
+| `plugin-creator` | Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow. | user | `/Users/rperaza/.codex/skills/.system/plugin-creator/SKILL.md` |
+| `pretty-mermaid` | Render beautiful Mermaid diagrams as SVG or ASCII art using the beautiful-mermaid library. Supports 15+ themes, 5 diagram types (flowchart, sequence, state, class, ER), and ultra-fast rendering.  Use this skill when: 1. User asks to "render a mermaid diagram" or provides .mmd files 2. User requests "create a flowchart/sequence diagram/state diagram" 3. User wants to "apply a theme" or "beautify a diagram" 4. User needs to "batch process multiple diagrams" 5. User mentions "ASCII diagram" or "terminal-friendly diagram" 6. User wants to visualize architecture, workflows, or data models | user | `/Users/rperaza/.agents/skills/pretty-mermaid/SKILL.md` |
+| `project-brain` | Session memory for AI agents — load context at the start, save sessions at the end, evolve knowledge across sessions. Like a professional's notebook: open before work, write a summary when done, persist between sessions. Trigger: When starting a session and need to recover context, or ending a session and want to save what happened. | user | `/Users/rperaza/.agents/skills/project-brain/SKILL.md` |
+| `prompt-improver` | Analyze and improve prompts using Claude's official prompting best practices. Use this skill whenever the user wants to improve, refine, review, or optimize a prompt — whether it's a system prompt, a user prompt, an API prompt, or instructions for an AI agent. Also trigger when the user shares a raw prompt and asks for feedback, says 'make this prompt better', 'optimize my prompt', 'review this prompt', or pastes a prompt and asks what's wrong with it. Even if the user just says 'improve this' while sharing text that looks like a prompt or instruction set, use this skill. | user | `/Users/rperaza/.agents/skills/prompt-improver/SKILL.md` |
+| `qa-review` | — | user | `/Users/rperaza/.agents/skills/qa-review/SKILL.md` |
+| `quant-playbook` | Quantitative prediction & trading playbook: proper evaluation metrics, model selection, backtesting methodology, risk management, and calibration for binary prediction systems. Trigger: When building, evaluating, or improving any prediction model, trading bot, forecasting system, or binary market strategy. | user | `/Users/rperaza/.agents/skills/quant-playbook/SKILL.md` |
+| `react-19` | React 19 patterns with React Compiler. Trigger: When writing React 19 components/hooks in .tsx (React Compiler rules, hook patterns, refs as props). If using Next.js App Router/Server Actions, also use nextjs-15. | user | `/Users/rperaza/.agents/skills/react-19/SKILL.md` |
+| `skill-creator` | Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter. | user | `/Users/rperaza/.config/opencode/skills/skill-creator/SKILL.md` |
+| `skill-improver` | Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills. | user | `/Users/rperaza/.config/opencode/skills/skill-improver/SKILL.md` |
+| `skill-installer` | Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos). | user | `/Users/rperaza/.codex/skills/.system/skill-installer/SKILL.md` |
+| `typescript` | TypeScript strict patterns and best practices. Trigger: When implementing or refactoring TypeScript in .ts/.tsx (types, interfaces, generics, const maps, type guards, removing any, tightening unknown). | user | `/Users/rperaza/.agents/skills/typescript/SKILL.md` |
+| `typescript-advanced-types` | Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects. | user | `/Users/rperaza/.agents/skills/typescript-advanced-types.bak/SKILL.md` |
+| `work-unit-commits` | Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code. | user | `/Users/rperaza/.config/opencode/skills/work-unit-commits/SKILL.md` |
+
+## Loading protocol
+
+1. Match task context and target files against the `Trigger / description` column.
+2. Pass only the matching `Path` values to the subagent under `## Skills to load before work`.
+3. Instruct the subagent to read those exact `SKILL.md` files before reading, writing, reviewing, testing, or creating artifacts.
+4. If no matching skill exists, proceed without project skill injection and report `skill_resolution: none`.

assets_metadata_remover-1.0.0/.gitignore

@@ -0,0 +1,28 @@
+PLAN.md
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db

assets_metadata_remover-1.0.0/Makefile

@@ -0,0 +1,40 @@
+PYTHON := python3
+SCRIPT := metadata_remover.py
+INPUT  ?= .
+OUTPUT ?=
+
+FLAGS :=
+ifdef VERBOSE
+  FLAGS += -v
+endif
+ifdef VERIFY
+  FLAGS += --verify
+endif
+ifdef OUTPUT
+  FLAGS += -o $(OUTPUT)
+endif
+
+.PHONY: help run dry-run verify test clean
+
+help:
+	@$(PYTHON) $(SCRIPT) --help
+
+run:
+	$(PYTHON) $(SCRIPT) $(INPUT) $(FLAGS)
+
+dry-run:
+	$(PYTHON) $(SCRIPT) $(INPUT) --dry-run $(FLAGS)
+
+verify:
+	$(PYTHON) $(SCRIPT) $(INPUT) --verify $(FLAGS)
+
+test:
+	@echo "=== Smoke test ===" && $(PYTHON) $(SCRIPT) --help > /dev/null && echo "PASS"
+	@echo "=== Dry run ===" && mkdir -p /tmp/mr_test/sub && $(PYTHON) $(SCRIPT) /tmp/mr_test --dry-run -v && echo "PASS"
+	@echo "=== Real run ===" && rm -rf /tmp/mr_test_clean && $(PYTHON) $(SCRIPT) /tmp/mr_test -v --verify && echo "PASS"
+	@echo "=== Empty dir ===" && mkdir -p /tmp/mr_empty && $(PYTHON) $(SCRIPT) /tmp/mr_empty && echo "PASS"
+	@echo "=== Non-existent ===" && $(PYTHON) $(SCRIPT) /tmp/mr_nonexistent 2>&1; echo "Exit: $$?"
+	@echo "=== All tests done ==="
+
+clean:
+	rm -rf /tmp/mr_test /tmp/mr_test_clean /tmp/mr_empty /tmp/mr_empty_clean

assets_metadata_remover-1.0.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: assets-metadata-remover
+Version: 1.0.0
+Summary: Remove metadata from images and videos recursively
+Project-URL: Homepage, https://github.com/synapsync/assets-metadata-remover
+Project-URL: Repository, https://github.com/synapsync/assets-metadata-remover
+Author: Synapsync
+License-Expression: MIT
+Keywords: exif,images,metadata,privacy,videos
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Security
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# assets-metadata-remover
+
+Command-line tool that removes metadata from images and videos recursively, generating clean copies in an output folder that mirrors the original structure. Original files are **never** modified.
+
+## Installation
+
+### With pipx (recommended)
+
+```bash
+pipx install assets-metadata-remover
+```
+
+### With pip
+
+```bash
+pip install assets-metadata-remover
+```
+
+### System dependencies
+
+- **ffmpeg** — required for video processing
+- **exiftool** — required for image processing
+
+Install with Homebrew:
+
+```bash
+brew install ffmpeg exiftool
+```
+
+> If a tool is missing, the script detects it at startup and processes only the files it can, showing a clear warning.
+
+## Basic usage
+
+```bash
+assets-metadata-remover /path/to/your_files
+```
+
+This creates `/path/to/your_files_clean/` with the same folder structure and metadata-free files.
+
+### Options
+
+```
+usage: assets-metadata-remover [-h] [-o OUTPUT] [--dry-run] [-v] [--verify] input
+
+positional:
+  input              Directory (or file) to process
+
+options:
+  -o, --output DIR   Output directory (default: <input>_clean)
+  --dry-run          Simulate without writing
+  -v, --verbose      Per-file logging
+  --verify           Re-inspect copies and report residual metadata
+```
+
+### Examples
+
+Process a directory with custom output:
+
+```bash
+assets-metadata-remover ~/Photos -o ~/Photos_clean
+```
+
+Simulate without writing (dry run):
+
+```bash
+assets-metadata-remover ~/Photos --dry-run
+```
+
+Verbose mode with cleanup verification:
+
+```bash
+assets-metadata-remover ~/Photos -v --verify
+```
+
+Process a single file:
+
+```bash
+assets-metadata-remover ~/photo.jpg -o ~/clean/
+```
+
+## Safety
+
+Original files are **never** modified. The script always writes to a separate output folder.
+
+## Supported formats
+
+**Images:** JPG, JPEG, PNG, TIFF, TIF, WebP, HEIC, HEIF, GIF, BMP
+
+**Videos:** MP4, MOV, MKV, AVI, M4V, WebM, WMV, FLV, 3GP
+
+Extension comparison is case-insensitive (`.JPG` and `.jpg` are equivalent).
+
+## Limitations
+
+- Videos are copied without re-encoding (`-c copy`), which is fast and lossless, but some exotic formats may not be compatible with the output container.
+- Some metadata embedded in proprietary formats may not be fully removed by `exiftool`.
+- Directory symlinks are not followed to avoid loops.

assets_metadata_remover-1.0.0/README.md

@@ -0,0 +1,97 @@
+# assets-metadata-remover
+
+Command-line tool that removes metadata from images and videos recursively, generating clean copies in an output folder that mirrors the original structure. Original files are **never** modified.
+
+## Installation
+
+### With pipx (recommended)
+
+```bash
+pipx install assets-metadata-remover
+```
+
+### With pip
+
+```bash
+pip install assets-metadata-remover
+```
+
+### System dependencies
+
+- **ffmpeg** — required for video processing
+- **exiftool** — required for image processing
+
+Install with Homebrew:
+
+```bash
+brew install ffmpeg exiftool
+```
+
+> If a tool is missing, the script detects it at startup and processes only the files it can, showing a clear warning.
+
+## Basic usage
+
+```bash
+assets-metadata-remover /path/to/your_files
+```
+
+This creates `/path/to/your_files_clean/` with the same folder structure and metadata-free files.
+
+### Options
+
+```
+usage: assets-metadata-remover [-h] [-o OUTPUT] [--dry-run] [-v] [--verify] input
+
+positional:
+  input              Directory (or file) to process
+
+options:
+  -o, --output DIR   Output directory (default: <input>_clean)
+  --dry-run          Simulate without writing
+  -v, --verbose      Per-file logging
+  --verify           Re-inspect copies and report residual metadata
+```
+
+### Examples
+
+Process a directory with custom output:
+
+```bash
+assets-metadata-remover ~/Photos -o ~/Photos_clean
+```
+
+Simulate without writing (dry run):
+
+```bash
+assets-metadata-remover ~/Photos --dry-run
+```
+
+Verbose mode with cleanup verification:
+
+```bash
+assets-metadata-remover ~/Photos -v --verify
+```
+
+Process a single file:
+
+```bash
+assets-metadata-remover ~/photo.jpg -o ~/clean/
+```
+
+## Safety
+
+Original files are **never** modified. The script always writes to a separate output folder.
+
+## Supported formats
+
+**Images:** JPG, JPEG, PNG, TIFF, TIF, WebP, HEIC, HEIF, GIF, BMP
+
+**Videos:** MP4, MOV, MKV, AVI, M4V, WebM, WMV, FLV, 3GP
+
+Extension comparison is case-insensitive (`.JPG` and `.jpg` are equivalent).
+
+## Limitations
+
+- Videos are copied without re-encoding (`-c copy`), which is fast and lossless, but some exotic formats may not be compatible with the output container.
+- Some metadata embedded in proprietary formats may not be fully removed by `exiftool`.
+- Directory symlinks are not followed to avoid loops.

assets_metadata_remover-1.0.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "assets-metadata-remover"
+version = "1.0.0"
+description = "Remove metadata from images and videos recursively"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "Synapsync" }
+]
+keywords = ["metadata", "exif", "privacy", "images", "videos"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Security",
+]
+
+[project.scripts]
+assets-metadata-remover = "metadata_remover.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/synapsync/assets-metadata-remover"
+Repository = "https://github.com/synapsync/assets-metadata-remover"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/metadata_remover"]

assets_metadata_remover-1.0.0/src/metadata_remover/__init__.py

@@ -0,0 +1,3 @@
+"""Remove metadata from images and videos recursively."""
+
+__version__ = "1.0.0"

assets_metadata_remover-1.0.0/src/metadata_remover/cli.py

@@ -0,0 +1,273 @@
+#!/usr/bin/env python3
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+IMAGE_EXTS = {".jpg", ".jpeg", ".png", ".tiff", ".tif", ".webp", ".heic", ".heif", ".gif", ".bmp"}
+VIDEO_EXTS = {".mp4", ".mov", ".mkv", ".avi", ".m4v", ".webm", ".wmv", ".flv", ".3gp"}
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description="Remove metadata from images and videos recursively."
+    )
+    parser.add_argument("input", help="Directory (or file) to process")
+    parser.add_argument("-o", "--output", help="Output directory (default: <input>_clean)")
+    parser.add_argument("--dry-run", action="store_true", help="Simulate without writing")
+    parser.add_argument("-v", "--verbose", action="store_true", help="Per-file logging")
+    parser.add_argument("--verify", action="store_true", help="Re-inspect copies and report residual metadata")
+    return parser.parse_args()
+
+
+def check_tools():
+    return {
+        "exiftool": shutil.which("exiftool") is not None,
+        "ffmpeg": shutil.which("ffmpeg") is not None,
+        "ffprobe": shutil.which("ffprobe") is not None,
+    }
+
+
+def collect_files(root):
+    root = Path(root).resolve()
+    results = []
+    if root.is_file():
+        ext = root.suffix.lower()
+        if ext in IMAGE_EXTS:
+            results.append((root, "image"))
+        elif ext in VIDEO_EXTS:
+            results.append((root, "video"))
+        else:
+            results.append((root, "unsupported"))
+        return results
+
+    for dirpath, dirnames, filenames in os.walk(str(root), followlinks=False):
+        dirnames[:] = [d for d in dirnames if not os.path.islink(os.path.join(dirpath, d))]
+        for fname in filenames:
+            fpath = Path(dirpath) / fname
+            ext = fpath.suffix.lower()
+            if ext in IMAGE_EXTS:
+                results.append((fpath, "image"))
+            elif ext in VIDEO_EXTS:
+                results.append((fpath, "video"))
+            else:
+                results.append((fpath, "unsupported"))
+    return results
+
+
+def clean_image(src, dst):
+    if dst.exists():
+        dst.unlink()
+    cmd = ["exiftool", "-all=", "-o", str(dst), str(src)]
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    if result.returncode != 0:
+        raise RuntimeError(result.stderr.strip() or result.stdout.strip())
+
+
+def clean_video(src, dst):
+    if dst.exists():
+        dst.unlink()
+    cmd = [
+        "ffmpeg", "-y", "-i", str(src),
+        "-map_metadata", "-1",
+        "-map_chapters", "-1",
+        "-c", "copy",
+        str(dst),
+    ]
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    if result.returncode != 0:
+        raise RuntimeError(result.stderr.strip() or "ffmpeg error")
+
+
+def verify_clean(path, category, tools):
+    if category == "image":
+        if not tools["exiftool"]:
+            return None
+        cmd = ["exiftool", str(path)]
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        structural_prefixes = (
+            "exiftool version", "file name", "directory", "file size",
+            "file modification", "file access", "file inode", "file permissions",
+            "file type", "mime type", "image width", "image height",
+            "bits per sample", "color components", "compression", "orientation",
+            "x resolution", "y resolution", "resolution unit", "exif byte order",
+            "jfif version", "jfif resolution", "color space", "pixel aspect ratio",
+            "duration", "avg bitrate", "bit depth", "color type", "filter",
+            "interlace", "image size", "megapixels",
+        )
+        lines = [
+            l.strip() for l in result.stdout.splitlines()
+            if l.strip() and not l.lower().startswith(structural_prefixes)
+        ]
+        return lines
+    elif category == "video":
+        if not tools["ffmpeg"]:
+            return None
+        if not tools["ffprobe"]:
+            return None
+        cmd = ["ffprobe", "-v", "quiet", "-show_entries", "format_tags:stream_tags", str(path)]
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        structural_tags = {
+            "major_brand", "minor_version", "compatible_brands",
+            "handler_name", "vendor_id", "encoder", "language",
+        }
+        lines = []
+        for l in result.stdout.splitlines():
+            l = l.strip()
+            if not l or l.startswith("["):
+                continue
+            upper = l.upper()
+            if "TAG:" not in upper:
+                continue
+            tag_name = l.split("=", 1)[0].replace("TAG:", "").strip().lower()
+            if tag_name not in structural_tags:
+                lines.append(l)
+        return lines
+    return None
+
+
+def print_summary(stats):
+    print()
+    print(f"  \u2714 Images cleaned: {stats['images_cleaned']}")
+    print(f"  \u2714 Videos cleaned: {stats['videos_cleaned']}")
+
+    skip_parts = []
+    if stats["unsupported"] > 0:
+        skip_parts.append(f"{stats['unsupported']} unsupported")
+    if stats["missing_tool"] > 0:
+        skip_parts.append(f"{stats['missing_tool']} missing tool")
+    skip_detail = f"  ({', '.join(skip_parts)})" if skip_parts else ""
+    print(f"  \u23ed Skipped:          {stats['skipped']}{skip_detail}")
+    print(f"  \u2716 Errors:           {stats['errors']}")
+    print(f"  \U0001F4C1 Output: {stats['output_dir']}")
+    print()
+
+
+def main():
+    args = parse_args()
+    input_path = Path(args.input).resolve()
+
+    if not input_path.exists():
+        print(f"Error: '{args.input}' does not exist.", file=sys.stderr)
+        sys.exit(2)
+
+    if args.output:
+        output_path = Path(args.output).resolve()
+    else:
+        output_path = Path(str(input_path) + "_clean")
+
+    tools = check_tools()
+
+    if not tools["exiftool"]:
+        print("WARNING: exiftool not found. Images will be skipped.")
+        print("  Install with: brew install exiftool")
+        print()
+    if not tools["ffmpeg"]:
+        print("WARNING: ffmpeg not found. Videos will be skipped.")
+        print("  Install with: brew install ffmpeg")
+        print()
+    if not tools["ffprobe"]:
+        if args.verify:
+            print("WARNING: ffprobe not found. Video verification will not work.")
+            print("  Install with: brew install ffmpeg  (includes ffprobe)")
+            print()
+
+    files = collect_files(input_path)
+
+    input_real = os.path.realpath(str(input_path))
+    output_real = os.path.realpath(str(output_path))
+
+    if input_real.startswith(output_real + os.sep):
+        print(f"Error: output directory cannot be a parent of input.", file=sys.stderr)
+        print(f"  Input:  {input_real}", file=sys.stderr)
+        print(f"  Output: {output_real}", file=sys.stderr)
+        sys.exit(2)
+
+    stats = {
+        "images_cleaned": 0,
+        "videos_cleaned": 0,
+        "skipped": 0,
+        "unsupported": 0,
+        "missing_tool": 0,
+        "errors": 0,
+        "output_dir": str(output_path),
+    }
+
+    for src, category in files:
+        src_resolved = os.path.realpath(str(src))
+
+        if src_resolved.startswith(output_real + os.sep) or src_resolved == output_real:
+            continue
+
+        if category == "unsupported":
+            stats["skipped"] += 1
+            stats["unsupported"] += 1
+            if args.verbose:
+                print(f"  SKIP (unsupported): {src}")
+            continue
+
+        if category == "image" and not tools["exiftool"]:
+            stats["skipped"] += 1
+            stats["missing_tool"] += 1
+            if args.verbose:
+                print(f"  SKIP (exiftool missing): {src}")
+            continue
+
+        if category == "video" and not tools["ffmpeg"]:
+            stats["skipped"] += 1
+            stats["missing_tool"] += 1
+            if args.verbose:
+                print(f"  SKIP (ffmpeg missing): {src}")
+            continue
+
+        if input_path.is_file():
+            dst = output_path / src.name
+        else:
+            rel = src.relative_to(input_path)
+            dst = output_path / rel
+
+        if args.dry_run:
+            print(f"  WOULD CLEAN: {src} -> {dst}")
+            if category == "image":
+                stats["images_cleaned"] += 1
+            else:
+                stats["videos_cleaned"] += 1
+            continue
+
+        try:
+            dst.parent.mkdir(parents=True, exist_ok=True)
+
+            if args.verbose:
+                print(f"  CLEANING: {src} -> {dst}")
+
+            if category == "image":
+                clean_image(src, dst)
+                stats["images_cleaned"] += 1
+            else:
+                clean_video(src, dst)
+                stats["videos_cleaned"] += 1
+
+            if args.verify:
+                residual = verify_clean(dst, category, tools)
+                if residual is None:
+                    if args.verbose:
+                        print(f"    VERIFY: skipped (tool not available)")
+                elif residual:
+                    print(f"    VERIFY WARNING: residual metadata in {dst}:")
+                    for line in residual:
+                        print(f"      {line}")
+                else:
+                    if args.verbose:
+                        print(f"    VERIFY OK: no residual metadata")
+
+        except Exception as e:
+            stats["errors"] += 1
+            print(f"  ERROR: {src}: {e}", file=sys.stderr)
+
+    print_summary(stats)
+
+
+if __name__ == "__main__":
+    main()