Skip to main content

A simple EXIF metadata viewer and editor.

Project description

ExifPlus

PyPI version Python versions License Tests

ExifPlus - Short Description & ReadMe

ExifPlus is a versatile and user-friendly metadata viewer and editor for image and video files. It allows you to view and modify EXIF, IPTC, and XMP metadata, making it an essential tool for photographers, videographers, and anyone who needs to manage media metadata easily. With a sleek GUI powered by ttkbootstrap and advanced functionality through libraries like pyexiv2, hachoir, and exifread, ExifPlus makes it simple to interact with file metadata in just a few clicks.


ReadMe & Instruction Manual

ExifPlus - Metadata Viewer and Editor

Overview

ExifPlus is a modern and intuitive tool designed for managing metadata in image and video files. Whether you're a photographer looking to adjust your photo's metadata or a content creator dealing with video files, ExifPlus offers powerful features to read and modify various types of metadata like EXIF, IPTC, and XMP.

Key Features

  • Read and Edit EXIF, IPTC, and XMP metadata from images and videos.
  • User-friendly GUI built with tkinter and ttkbootstrap for a sleek and responsive interface.
  • Supports multiple media formats including .jpg, .png, .tiff, .heic, .mp4, .avi, .mov, and .mkv.
  • Batch processing to edit metadata across multiple files (future versions).
  • Save changes to metadata and overwrite the original file.
  • Context Menu with an option to delete rows of metadata for easy data management, or add new rows.
  • Export the data as CSV or JSON
  • Cross-platform support (Windows, macOS, Linux).

Installation

You can install ExifPlus directly from PyPI using pip. To install the package, simply run the following command in your terminal or command prompt:

pip install exifplus

Ensure that you have the required dependencies installed for full functionality:

  • pyexiv2 (for metadata extraction and editing)
  • hachoir (for reading video metadata)
  • ttkbootstrap (for the GUI)
pip install pyexiv2 hachoir ttkbootstrap

Usage

  1. Launch ExifPlus: After installation, you can run ExifPlus directly from the command line (or from your Python script).

    python -m exifplus
    

    This will open the ExifPlus GUI, where you can load your files and begin editing metadata.

  2. Open File: Click the "Open File" button to choose an image or video file. Supported formats include:

    • Images: .jpg, .jpeg, .png, .tiff, .heic
    • Videos: .mp4, .mov, .avi, .mkv
  3. View and Edit Metadata: Once the file is loaded, the metadata will be displayed in a table format with columns for the metadata Key and Value. You can:

    • Double-click a cell to edit its value.
    • Right-click to bring up a context menu with options like deleting the metadata row.
  4. Save Metadata: After editing metadata, click the "Save Metadata" button to save your changes. The metadata will be saved back to the file.

  5. Delete Metadata Row: To delete a specific metadata entry, right-click on a row and select "Delete Row". A confirmation dialog will appear to ensure you want to proceed with the deletion.

  6. About Window: Click on the "About" button to view information about the tool and the author.

Troubleshooting

  • Error: pyexiv2 is missing or fails to load: Make sure you've installed the necessary dependencies. You may need to install system packages for pyexiv2 to work properly on some systems (Linux or macOS). Refer to the pyexiv2 documentation for installation instructions.

  • Error: Invalid metadata key: When trying to modify metadata, ensure that the key you're trying to modify exists in the original file. You can view all the available keys in the table after loading a file.

📦 Installation

🔹 Recommended (Pipx)

If you intend to run ExifPlus as an application:

pipx install exifplus

Then run it:

exifplus

🔹 Using pip (Virtual Environment)

python3 -m venv venv
source venv/bin/activate
pip install exifplus

Run:

exifplus

⚠️ Debian/Ubuntu/Parrot/Kali Users

These systems use PEP 668 and block global installs. If you try:

pip install exifplus

You may see:

error: externally-managed-environment

To fix, use either:

pipx install exifplus

or:

python3 -m venv venv
source venv/bin/activate
pip install exifplus

🔧 Optional (Not required but allowed)

If you really want to install system-wide:

pip install exifplus --break-system-packages

Not recommended.


🚀 Running

After installation:

exifplus

or

python -m exifplus

Screenshot

ExifPlus Screenshot ExifPlus Screenshot ExifPlus Screenshot


Contributing

Contributions to ExifPlus are welcome! If you'd like to report a bug, suggest a feature, or submit a pull request, feel free to fork the project and submit changes.

  1. Fork the repository.
  2. Clone your fork to your local machine.
  3. Make your changes (bug fixes, features, improvements).
  4. Submit a pull request with a clear description of your changes.

👨‍💻 Author

Developed by:

👉 Mohammed Zahid Wadiwale

Support development by buying:

  • Hosting
  • Domains
  • Websites
  • Cybersecurity services
  • Courses

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

exifplus-1.1.6.tar.gz (12.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

exifplus-1.1.6-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file exifplus-1.1.6.tar.gz.

File metadata

  • Download URL: exifplus-1.1.6.tar.gz
  • Upload date:
  • Size: 12.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for exifplus-1.1.6.tar.gz
Algorithm Hash digest
SHA256 aa8e54bc9af8d357e83f0145b9ab52885c1da0c708533da7914bc248bc69743e
MD5 f7f99c30ec70cfea3db39e44f1d1beb6
BLAKE2b-256 24da9bc19eafd2701df3033b15c05c5f1d90c7c45e3c64969612c0a7ed6b19b8

See more details on using hashes here.

File details

Details for the file exifplus-1.1.6-py3-none-any.whl.

File metadata

  • Download URL: exifplus-1.1.6-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for exifplus-1.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 06316f381c322c30d7ed7365e7385a188f3271349a235674e837f5dbd5056963
MD5 04ddf8386e4be1690ec045d991e2633b
BLAKE2b-256 1cc3bbcc0a4993d66c874a7736e437563898e8712ccefc6b170d1de395cb1f43

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page