AutoExif CLI w/TUI

April 23, 2025 · View on GitHub

AutoExif

GitHub Stars GitHub Forks GitHub Watchers
PyPI Downloads MIT License

AutoExif CLI w/TUI

A super user-friendly CLI tool for extracting and manipulating metadata from files and URLs.

🚀 Features

  • Read metadata from images and videos
  • Extract metadata from local files and URLs
  • Wipe specific metadata (e.g., GPS)
  • Super Easy setup for Windows & Linux Distro's

Q/A

  • Q: Where is the original bash version?
  • A: Here

  • Q: Where is the standalone .exe?
  • A: Check Releases Here

Preview

Click to expand!
  • Linux

image

image

image

  • Windows

image

autoexif-cli

autoexif-cl1

📦 Installation

Install via pip:

pip install autoexif

or build & install yourself from source.

1. Clone the repository

git clone https://github.com/SirCryptic/autoexif.git
cd autoexif

2. Install Python and dependencies

Make sure you have Python 3.11+ installed.

pip install -r requirements.txt

3. Install the CLI tool

windows

python setup.py install

linux

sudo python3 setup.py install
  • Windows: Copies exiftool.exe and exiftool_files.zip to C:\Users\AppData\Local\autoexif, extracting the zip.
  • Linux: Auto-installs ExifTool using your system's package manager or downloads it to ~/.autoexif/ if needed.

🛠️ Usage

Get started with:

autoexif help
  • Short Version Of help
autoexif --help
  • Open TUI
autoexif

📷 Examples

Read metadata from an image in the current directory:

autoexif read

Read metadata from a specific image:

autoexif read sample.jpg

Read detailed metadata:

autoexif read sample.jpg --detailed

Read metadata from a URL:

autoexif read https://example.com/image.jpg

Wipe GPS data:

autoexif wipe sample.jpg --type gps

Extract GPS from a video:

autoexif gps video.mp4

Get thumbnail metadata:

autoexif thumbnail sample.jpg

Get expert-level metadata:

autoexif expert sample.jpg

📌 Notes

  • Windows: Installation copies exiftool.exe and exiftool_files.zip to C:\Users<YourUser>\AppData\Local\autoexif
    and extracts the required files.

  • Linux: Auto-installs ExifTool using your system's package manager or downloads it to ~/.autoexif/ if needed.

  • Ethical Use: Only process files and URLs you are authorized to access.

  • Help: Run autoexif help for more details and usage options.

Made with ❤️ by SirCryptic