Skip to content

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 πŸ‘‡

updated readme and version

HERITAGE-XION9d5b32d4d70f
diff --git a/README.md b/README.md
index 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.
[![Tests](https://github.com/Heritage-XioN/metadata-scrubber-tool/actions/workflows/test.yml/badge.svg)](https://github.com/Heritage-XioN/metadata-scrubber-tool/actions)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](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 folder
mst 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
```bash
mst 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
```bash
mst 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
## πŸ“„ License
diff --git a/pyproject.toml b/pyproject.toml
index 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.py
index 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"
# ---------------------------------------------------------