Skip to content

ScoofyTheFox/File-Data-Editor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—‚οΈ File Data Editor

by scoofyx Β· Β© 2026

View, edit, spoof, wipe, and export image metadata β€” in the browser or terminal.

License: MIT Platform Python Browser


Screenshot 2026-03-20 123122

πŸ“Œ What is EXIF?

EXIF (Exchangeable Image File Format) is hidden metadata baked into every image file. It records things like camera model, GPS coordinates, date taken, lens settings, ISO, and more. Every photo you shoot with a phone or camera has it β€” most people never see it.

File Data Editor lets you see all of it, and change any of it.


⚑ Quick Start

πŸ† Recommendation β€” Use the Web Version

Open medit-site/medit.html in your browser. That's it. No Python, no install, no terminal. Works on any device with a browser. The CLI is a bonus for power users and batch automation.


🌐 Web Version [RECOMMENDED]

Screenshot 2026-03-20 123652

Usage

  1. Open medit-site/medit.html in any browser
  2. Drag & drop your image (or click to browse)
  3. Pick a category from the sidebar
  4. Click any field β†’ type a new value β†’ it saves instantly
  5. Hit ↓ Download to get your edited image
Screenshot 2026-03-20 123831

Supported Formats

Format View Edit Download with edits
JPG / JPEG βœ… βœ… βœ… Full support
PNG βœ… βœ… ⚠️ Re-downloads original
GIF βœ… βœ… ⚠️ Re-downloads original
WEBP βœ… βœ… ⚠️ Re-downloads original

EXIF embedding on download is JPEG-only due to a browser limitation. Use JPG for the full experience.


πŸ’» CLI Version

Screenshot 2026-03-20 124419

Install

pip install -r medit-cmd/requirements.txt

Run

# Drop image.jpg in the same folder, then:
py medit.py

# Or pass a path directly:
py medit.py "C:\Users\you\Pictures\photo.jpg"

Works in both cmd and PowerShell.

Dependencies

Pillow>=10.0.0
piexif>=1.1.3
cryptography>=41.0.0
numpy>=1.24.0

πŸ–₯️ Setup by OS

πŸͺŸ Windows

Click to expand

1. Install Python

  • Go to python.org/downloads and download the latest 3.x installer
  • βœ… Check "Add Python to PATH" during install β€” this is important

2. Download the project

  • Click Code β†’ Download ZIP on GitHub, then extract it

3. Install dependencies

  • Open the medit-cmd folder
  • Hold Shift + right-click inside the folder β†’ Open PowerShell window here
  • Run:
pip install -r requirements.txt

4. Run

py medit.py

Web version: just double-click medit-site/medit.html β€” opens in your default browser.


🍎 macOS

Click to expand

1. Install Python

macOS may have Python 2 built in β€” you need Python 3. Use Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install python

Or download directly from python.org/downloads.

2. Download the project

  • Click Code β†’ Download ZIP on GitHub, then extract it
  • Or clone it:
git clone https://github.com/scoofyx/file-data-editor.git
cd file-data-editor

3. Install dependencies

cd medit-cmd
pip3 install -r requirements.txt

4. Run

python3 medit.py

Web version: double-click medit-site/medit.html β€” or right-click β†’ Open With β†’ your browser.


🐧 Linux

Click to expand

1. Install Python & pip

Python 3 is usually pre-installed. If not:

# Ubuntu / Debian
sudo apt update && sudo apt install python3 python3-pip

# Arch
sudo pacman -S python python-pip

# Fedora
sudo dnf install python3 python3-pip

2. Download the project

git clone https://github.com/scoofyx/file-data-editor.git
cd file-data-editor

3. Install dependencies

cd medit-cmd
pip3 install -r requirements.txt

If you get a permissions error, use:

pip3 install -r requirements.txt --user

4. Run

python3 medit.py

Web version: open medit-site/medit.html in Firefox or Chromium.

xdg-open medit-site/medit.html

✨ Features

Both Versions

Feature Description
πŸ“‹ View metadata Full structured report across 6 categories
✏️ Edit any field Browse by category, pick by number or click
πŸ“ GPS editor Decimal degrees in β†’ DMS stored automatically
πŸ“… Date & Time Set all dates at once, or shift by Β±N hours
πŸ“± Fake device Spoof as iPhone 15 Pro, Galaxy S24, Pixel 8 Pro, or custom
πŸ’€ Wipe metadata Strip all EXIF from the image in one click
πŸ’Ύ Export report Save a full .txt metadata report

CLI Only

Feature Description
πŸ” Encrypt tag Store an encrypted secret in a custom EXIF tag (Fernet)
πŸ”“ Decrypt tag Recover it with your key
πŸ•΅οΈ Hide message LSB steganography β€” hide text invisibly in pixel data
πŸ” Extract message Read a hidden message back out of any image
πŸ” Clone EXIF Copy all metadata from one image onto another
Screenshot 2026-03-20 124518

πŸ“‚ Editable Categories

Category Notable Fields
πŸ“· Camera Information Make, Model, Lens Model, Serial Number, Software
🎞️ Image Settings ISO, F-Number, Exposure, Focal Length, Flash, White Balance
🌍 GPS Data Latitude, Longitude, Altitude, Speed, Direction
πŸ• Date & Time Original, Digitized, Modify Date, Sub Sec fields
✍️ Author & Copyright Artist, Copyright, Image Description, User Comment, Maker Note
πŸ–ΌοΈ Image Properties Width, Height, Color Space, Resolution, Exif Version, Compression

πŸ“– Field Format Reference

Label What to type Example
text Plain string Apple
int Whole number 100
ratio Fraction or decimal 1/100 or 2.8
deg Decimal degrees 44.4268
ref Single letter N S E W
datetime Date/time string or now 2026:03:20 14:30:00

πŸ—ƒοΈ Project Structure

File Data Editor/
β”œβ”€β”€ README.md                 ← you are here
β”œβ”€β”€ LICENSE
β”œβ”€β”€ medit-site/
β”‚   β”œβ”€β”€ medit.html            ← web app β€” just open this
β”‚   └── README.md
└── medit-cmd/
    β”œβ”€β”€ medit.py              ← CLI tool
    β”œβ”€β”€ requirements.txt
    └── README.md

πŸ”’ Privacy

Version Data handling
🌐 Web Runs 100% in your browser. Nothing is uploaded or sent anywhere.
πŸ’» CLI Runs entirely on your local machine. No network calls.

πŸ“ Notes

  • Original files are never modified until you explicitly save or download
  • CLI auto-backs up filename_backup.jpg before overwriting an existing output
  • Web version tested on Chrome, Edge, Firefox, Safari
  • Runs on Windows, macOS, Linux

File Data Editor β€” made by scoofyx

About

Tool for editing the data of files (.jpeg, .png, .jpg, .webp, .gif) (mainly made to edit metadata)

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages