Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
updated README
HERITAGE-XION5f5befab29ac
diff --git a/README.md b/README.mdindex 21c4e265..0228194f 100644--- a/README.md+++ b/README.md@@ -1,15 +1,121 @@-# Metadata Scrubber Tool+# π Metadata Scrubber Tool-A tool for scrubbing metadata from files.+A privacy-focused CLI tool that removes sensitive metadata (EXIF, GPS, author info) from image files. Perfect for protecting your privacy before sharing photos online.-## Installation+## β¨ Features++- **Multi-format support** - JPEG, PNG (with PDF/Office planned)+- **Concurrent processing** - Process 1000+ files efficiently with ThreadPoolExecutor+- **Dry-run mode** - Preview what would be scrubbed without making changes+- **Smart format detection** - Uses Pillow's format detection, not just file extensions+- **Beautiful CLI** - Rich progress bars and formatted output+- **Privacy-first** - Removes GPS coordinates, camera info, timestamps, author data++## π Educational Value++This project demonstrates:+- **Factory pattern** for extensible file type handling+- **Abstract base classes** for consistent handler interfaces+- **Concurrent processing** with thread-safe operations+- **CLI development** with Typer and Rich+- **Image metadata handling** with Pillow and piexif++## π Prerequisites++- Python 3.10++- [uv](https://github.com/astral-sh/uv) (recommended) or pip++## π Installation```bash+# Clone the repository+git clone https://github.com/Heritage-XioN/metadata-scrubber-tool.git+cd metadata-scrubber-tool++# Create virtual environment and install dependencies+uv venv+.venv\Scripts\activate # Windows+# source .venv/bin/activate # Linux/Mac+uv pip install -r requirements.txt```-## Usage+## π Usage++### Read Metadata++```bash+# Single file+python -m src.main read photo.jpg++# Recursive directory scan+python -m src.main read ./photos/ -r -ext jpg+```++### Scrub Metadata```bash-python -m src.main+# Single file+python -m src.main scrub photo.jpg --output ./cleaned++# Batch process with 8 workers+python -m src.main scrub ./photos/ -r -ext jpg --output ./cleaned --workers 8++# Preview without changes+python -m src.main scrub ./photos/ -r -ext jpg --dry-run```++### CLI Options++| Command | Options |+|---------|---------|+| `read` | `-r` / `--recursive`, `-ext` / `--extension` |+| `scrub` | `-r`, `-ext`, `-o` / `--output`, `-d` / `--dry-run`, `-w` / `--workers` |+| Global | `-v` / `--verbose` |++## ποΈ Architecture++```+src/+βββ main.py # CLI entry point (Typer app)+βββ commands/+β βββ read.py # Read metadata command+β βββ scrub.py # Scrub metadata command (batch processing)+βββ services/+β βββ metadata_factory.py # Factory for creating handlers+β βββ metadata_handler.py # Abstract base class+β βββ image_handler.py # JPEG/PNG handler+β βββ batch_processor.py # Concurrent batch processing+βββ core/+β βββ jpeg_metadata.py # JPEG EXIF processor (piexif)+β βββ png_metadata.py # PNG metadata processor (PIL)+βββ utils/+ βββ display.py # Rich output formatting+ βββ formatter.py # Value formatting helpers+ βββ exceptions.py # Custom exceptions+ βββ logger.py # Logging configuration+```++**Data Flow:**+```+CLI Command β MetadataFactory β Handler (readβwipeβsave) β Output+ β+ Format Detection+ β+ JpegProcessor / PngProcessor+```++## β οΈ Security Considerations++- **Always backup files** before scrubbing in production+- **Use `--dry-run`** to preview changes before committing+- **GPS coordinates** are completely stripped for privacy+- **Original files are not modified** - processed copies are created++## π License++MIT License - See [LICENSE](LICENSE) for details.++---++Made with β€οΈ for privacydiff --git a/examples/test_images/test_canon.jpg b/examples/test_images/test_canon.jpgnew file mode 100644index 00000000..6eb33f12Binary files /dev/null and b/examples/test_images/test_canon.jpg differdiff --git a/examples/test_images/test_fuji.jpg b/examples/test_images/test_fuji.jpgnew file mode 100644index 00000000..8cf1e5caBinary files /dev/null and b/examples/test_images/test_fuji.jpg differdiff --git a/examples/test_images/test_metadata.png b/examples/test_images/test_metadata.pngnew file mode 100644index 00000000..55aa11f8Binary files /dev/null and b/examples/test_images/test_metadata.png differ