Bumps [pypdf](https://github.com/py-pdf/pypdf) from 6.12.0 to 6.13.3. - [Release notes](https://github.com/py-pdf/pypdf/releases) - [Changelog](https://github.com/py-pdf/pypdf/blob/main/CHANGELOG.md) - [Commits](https://github.com/py-pdf/pypdf/compare/6.12.0...6.13.3) --- updated-dependencies: - dependency-name: pypdf dependency-version: 6.13.3 dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> |
||
|---|---|---|
| .. | ||
| assets | ||
| learn | ||
| scripts | ||
| src | ||
| tests | ||
| typings/piexif | ||
| .gitignore | ||
| .style.yapf | ||
| DEMO.md | ||
| LICENSE | ||
| README.md | ||
| justfile | ||
| pyproject.toml | ||
| pyrightconfig.json | ||
| uv.lock | ||
README.md
███╗ ███╗███████╗████████╗
████╗ ████║██╔════╝╚══██╔══╝
██╔████╔██║███████╗ ██║
██║╚██╔╝██║╚════██║ ██║
██║ ╚═╝ ██║███████║ ██║
╚═╝ ╚═╝╚══════╝ ╚═╝
Privacy-focused CLI that strips sensitive metadata from images, PDFs, and Office documents.
This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.
Developed by @Heritage-XioN
What It Does
- Strip metadata from JPEG, PNG, PDF, Word, Excel, and PowerPoint files
- Concurrent processing with ThreadPoolExecutor handles 1000+ files efficiently
- Dry-run mode previews what would be removed before making changes
- Verification reports show before/after comparison of metadata fields
- Smart format detection uses file signatures, not extensions
- Removes GPS coordinates, author info, timestamps, camera data, and software traces
Quick Start
uv tool install metadata-scrubber
mst scrub photo.jpg
[!TIP] This project uses
justas a command runner. Typejustto see all available commands.Install:
curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin
Commands
| Command | Description |
|---|---|
mst read <file> |
Inspect metadata fields present in a file |
mst scrub <file> |
Remove all metadata from a file |
mst verify <file> |
Confirm metadata was successfully removed |
Learn
This project includes step-by-step learning materials covering security theory, architecture, and implementation.
| Module | Topic |
|---|---|
| 00 - Overview | Prerequisites and quick start |
| 01 - Concepts | Security theory and real-world breaches |
| 02 - Architecture | System design and data flow |
| 03 - Implementation | Code walkthrough |
| 04 - Challenges | Extension ideas and exercises |
License
AGPL 3.0