Skip to content

xpux/Phantom

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phantom

Local EXIF metadata stripper(and viewer). Drop your photos in, it removes GPS coordinates, camera info, timestamps and everything else before you share them.

No APIs. No uploads. Fully local.


Quick start

git clone https://github.com/xpux/Phantom.git
cd Phantom
pip install -r requirements.txt
python phantom.py

What it strips

GPS coordinates, camera make and model, lens info, date taken, software used, artist, copyright, serial numbers, comments, descriptions, and any other EXIF metadata embedded in your photos.


Usage

Run it and enter a path when prompted:

python phantom.py

Or pass a path directly:

python phantom.py /path/to/photo.jpg
python phantom.py /path/to/folder

Process multiple photos at once by pointing it at a folder — it finds every supported image inside it.

Supported formats: JPG, JPEG, PNG, WebP


Flags

--preview      show what metadata is in the files without stripping anything
--in-place     overwrite the originals instead of saving clean copies to output/
--version      print version number

How it works

Phantom opens each image, reads out any embedded EXIF data, shows you what it found, then saves a clean copy with all metadata removed. Originals are never touched unless you use --in-place.


Configuration

Edit config.json to change defaults:

{
  "output_folder": "output",
  "show_preview": true,
  "in_place": false
}
Option Default Description
output_folder "output" Where clean copies are saved
show_preview true Show metadata found before stripping
in_place false Overwrite originals instead of saving copies

Privacy

Phantom runs entirely on your machine. No files are uploaded anywhere, no network requests are made, no data leaves your computer.


Requirements

Python 3.8+, Pillow, piexif


Disclaimer

Always keep backups of your original files. Phantom saves clean copies to the output folder by default and does not delete originals, but if you use --in-place the original metadata cannot be recovered.

About

Local EXIF metadata stripper. Removes GPS, camera info and timestamps from photos before you share them.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages