file-scrub 🧹

Strip hidden metadata offline — drag image/PDF, get clean file in 1s. Nothing leaves your machine.

People upload sensitive photos/PDFs to random sites to remove GPS, EXIF, author names. file-scrub does it 100% locally.

Quick Start

pip install file-scrub

# 1. Clean one file (creates *_scrubbed.jpg next to original, never overwrites)
file-scrub clean photo.jpg
file-scrub clean document.pdf -o clean.pdf

# 2. Clean a folder
file-scrub clean ./my-photos -r

# 3. History
file-scrub history

What it scrubs

• Images .jpg .jpeg .png .webp .tiff .bmp — EXIF, GPS, camera make/model, DPI, thumbnails (via Pillow, re-creates file without exif)
• PDFs .pdf — Author/Title/Producer/CreationDate, XMP metadata (via pypdf)
• Other files — copied as-is with _scrubbed suffix (safe, never overwrites)

Offline, SQLite history in .file-scrub.db, no cloud.

Install from source

git clone https://github.com/thehypewipe/file-scrub.git
cd file-scrub
pip install -e .
file-scrub clean tests

CLI

file-scrub clean <path>          # file or folder
file-scrub clean <path> -o out/  # custom output
file-scrub clean <path> -r       # recursive for folders
file-scrub history               # last 10 scrubs

Contributing

See CONTRIBUTING.md. Add new type in file_scrub/cleaner.py + test.

License

MIT — see LICENSE

---

If file-scrub saved you a privacy leak, star it ⭐