📷 Metadata Stripper

Your photos know more than you do. Read it, then erase it.

"The photo was innocent. The GPS coordinates were not."

What is it?

Every file whispers: where it was taken, with what camera, by whom and at what exact moment. That whisper is metadata — and half the time it includes GPS coordinates. Metadata Stripper v2 reads the whisper, shows it to you in a beautiful Textual TUI, and then removes it for good.

JPEG / PNG / WebP / TIFF / BMP / GIF / ICO     — EXIF, GPS, XMP, ICC, thumbnail
PDF                                           — document info, XMP packet
DOCX / XLSX / PPTX / ODT / ODS / ODP          — core/app/custom properties
ZIP                                           — comments, timestamps, junk files
MP3 / FLAC / WAV / OGG / OPUS                 — ID3, vorbis, RIFF INFO
MP4 / MOV / MKV / WEBM / AVI                  — tags, covr, LIST INFO
DOC / XLS / PPT / MSG (OLE2)                  — read-only analysis

Run it

pip install "metadata-stripper[all]"   # or: pip install -e .[all]
metastrip                              # 🚀 opens the TUI

metastrip with no arguments opens the Textual TUI — the main interface. All subcommands below also work for scripting.

The TUI

Six tabs, keyboard-first, dark theme with a fire-gradient dragon banner:

Key bindings: F5 rescan · Ctrl+S clean selection · Ctrl+B clean all · R rename · E export · Q quit.

CLI (scripting)

metastrip scan ~/fotos -v                    # risk report per file
metastrip exif photo.jpg                     # full technical dump
metastrip gps show photo.jpg                 # coordinates + cities + map URL
metastrip gps remove photo.jpg               # strip only GPS
metastrip strip photo.jpg --profile gps      # selective by profile
metastrip strip ./export --keep make,model   # keep camera info
metastrip batch ./export --workers 8 --report html
metastrip report ./dir --format html --out report.html
metastrip verify clean.jpg                   # exit 0 = clean
metastrip rename ./dir --mode random         # no date hints
metastrip profiles                           # list cleaning profiles

Cleaning profiles

Optional dependencies

Pillow + textual are required. Everything else is optional per format:

pip install "metadata-stripper[pdf]"    # pypdf
pip install "metadata-stripper[audio]"  # mutagen
pip install "metadata-stripper[ole]"    # olefile
pip install "metadata-stripper[all]"    # everything

Without an optional dep the format simply isn't registered (the TUI and CLI keep working) and a clear pip install hint is shown if you try to use it.

Tests

pip install pytest
pytest

109 tests cover every format handler, GPS parsing, risk scoring, batch, reports, rename and redaction.

License

MIT — clean your own files and let the protagonist's geotag be a plot point, not a leak.