Skip to main content

Simple XMP Image Tag & Metadata Editing Library

Project description

ImgTag

Simple XMP Image Tag & Metadata Editing Module

It is recomended to install using Conda to create a virtual python environment, as it makes it easy to install and manage different packages. Use the following commands to set up an environment:

conda env create -f environment.yml
conda activate imgtag

If you choose to install manually, you must install exempi for your OS.

For Debian:

sudo apt-get install -y exempi

For a Conda environment:

conda install -c conda-forge exempi

Once exempi is installed, install imgtag with:

python3 -m pip install -y imgtag

To use imgtag:

from imgtag import ImgTag

# Open image for tag editing
test = ImgTag(
           filename="test.jpg", # The image file
           force_case="lower",  # Converts the case of all tags
                                # Can be `None`, `"lower"`, `"upper"`
                                # Default: None
           strip=True,          # Strips whitespace from the ends of all tags
                                # Default: True
           no_duplicates=True   # Removes all duplicate tags (case sensitive)
                                # Default: True
       )

# Print existing tags
print("Current tags:")
for tag in test.get_tags():
    print("  Tag:", tag)

# Add tags
test.add_tags(["sleepy", "happy"])

# Remove tags
test.remove_tags(["cute"])

# Set tags, removing all existing tags
test.set_tags(["dog", "good boy"])

# Save changes and close file
test.close()

# Re-open for tag editing
test.open()

# Remove all tags
test.clear_tags()

# Delete the ImgTag object, automatically saving and closing the file
del(test)

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

imgtag-1.0.5.tar.gz (16.0 kB view details)

Uploaded Source

File details

Details for the file imgtag-1.0.5.tar.gz.

File metadata

  • Download URL: imgtag-1.0.5.tar.gz
  • Upload date:
  • Size: 16.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.7

File hashes

Hashes for imgtag-1.0.5.tar.gz
Algorithm Hash digest
SHA256 85bd1ea0a53029e1f2e168f7d8b5beeca122938a54b50a09e2122d3de2cbd9fc
MD5 7c15d63533e5b98a3eb18b25fa823518
BLAKE2b-256 0a9fb731ee25dc4b0c70e55a120873280ed355b1bd02d69976755035c9e7f071

See more details on using hashes here.

Supported by

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