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 and version
HERITAGE-XION9d5b32d4d70f
diff --git a/README.md b/README.mdindex 58a0f55d..3fdb130e 100644--- a/README.md+++ b/README.md@@ -1,6 +1,6 @@# π Metadata Scrubber-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.+A privacy-focused CLI tool that removes sensitive metadata from files. Supports images, PDFs, and Microsoft Office documents. Perfect for protecting your privacy before sharing files online.[](https://github.com/Heritage-XioN/metadata-scrubber-tool/actions)[](https://python.org)@@ -8,12 +8,22 @@ A privacy-focused CLI tool that removes sensitive metadata (EXIF, GPS, author in## β¨ Features-- **Multi-format support** - JPEG, PNG (with PDF/Office planned)+- **Multi-format support** - Images (JPEG, PNG), PDFs, and Office docs (Word, Excel, PowerPoint)- **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+- **Smart format detection** - Uses library-level format detection, not just file extensions- **Beautiful CLI** - Rich progress bars and formatted output-- **Privacy-first** - Removes GPS coordinates, camera info, timestamps, author data+- **Privacy-first** - Removes GPS coordinates, author info, timestamps, camera data++## π Supported Formats++| Category | Extensions | Metadata Removed |+|----------|------------|------------------|+| **Images** | `.jpg`, `.jpeg`, `.png` | EXIF, GPS, camera info, timestamps |+| **PDF** | `.pdf` | Author, creator, producer, dates |+| **Word** | `.docx` | Author, title, comments, keywords |+| **Excel** | `.xlsx`, `.xlsm`, `.xltx`, `.xltm` | Author, title, company, comments |+| **PowerPoint** | `.pptx`, `.pptm`, `.potx`, `.potm` | Author, title, comments, keywords |## π Quick Start@@ -33,13 +43,13 @@ uv sync```bash# Read metadata from a file-mst read photo.jpg+mst read document.pdf# Scrub metadata and save to output foldermst scrub photo.jpg --output ./cleaned# Batch process entire folder-mst scrub ./photos -r -ext jpg --output ./cleaned+mst scrub ./documents -r -ext docx --output ./cleaned```## π Commands@@ -48,16 +58,17 @@ mst scrub ./photos -r -ext jpg --output ./cleaned```bashmst read photo.jpg # Single file-mst read ./photos -r -ext jpg # Directory (recursive)+mst read report.pdf # PDF file+mst read ./docs -r -ext docx # All Word docs recursively```### `mst scrub` - Remove Metadata```bashmst scrub photo.jpg --output ./out # Single file-mst scrub ./photos -r -ext jpg -o ./out # Directory-mst scrub ./photos -r -ext jpg --dry-run # Preview only-mst scrub ./photos -r -ext jpg -w 8 # 8 concurrent workers+mst scrub ./photos -r -ext jpg -o ./out # All JPEGs in directory+mst scrub ./docs -r -ext pdf --dry-run # Preview PDF scrubbing+mst scrub ./files -r -ext xlsx -w 8 # 8 concurrent workers```### CLI Options@@ -65,7 +76,7 @@ mst scrub ./photos -r -ext jpg -w 8 # 8 concurrent workers| Option | Description ||--------|-------------|| `-r`, `--recursive` | Process directories recursively |-| `-ext`, `--extension` | Filter by file extension (jpg, png) |+| `-ext`, `--extension` | Filter by file extension || `-o`, `--output` | Output directory for cleaned files || `-d`, `--dry-run` | Preview without making changes || `-w`, `--workers` | Number of concurrent workers |@@ -103,7 +114,12 @@ src/β βββ scrub.py # Scrub metadata commandβββ services/β βββ metadata_factory.py # Factory for creating handlers+β βββ metadata_handler.py # Abstract base classβ βββ image_handler.py # JPEG/PNG handler+β βββ pdf_handler.py # PDF handler+β βββ excel_handler.py # Excel handler+β βββ powerpoint_handler.py # PowerPoint handler+β βββ worddoc_handler.py # Word document handlerβ βββ batch_processor.py # Concurrent batch processingβββ core/βββ jpeg_metadata.py # JPEG EXIF processor@@ -115,6 +131,7 @@ src/- **Original files are never modified** - processed copies are created- **Use `--dry-run`** to preview changes before committing- **GPS coordinates** are completely stripped for privacy+- **Author information** is removed from all supported formats- **Always backup files** before scrubbing in production## π Licensediff --git a/pyproject.toml b/pyproject.tomlindex d9f43c51..bb26f8cb 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -1,6 +1,6 @@[project]name = "metadata-scrubber"-version = "0.1.1"+version = "0.2.0"description = "A privacy-focused CLI tool that removes sensitive metadata from image files"readme = "README.md"requires-python = ">=3.10"diff --git a/src/main.py b/src/main.pyindex 99d4d0fc..89b5d22a 100644--- a/src/main.py+++ b/src/main.py@@ -22,7 +22,7 @@ app = typer.Typer(no_args_is_help=True, pretty_exceptions_show_locals=False)log = logging.getLogger("metadata-scrubber")-__version__ = "0.1.1"+__version__ = "0.2.0"# ---------------------------------------------------------