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
Release history Release notifications | RSS feed
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)
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85bd1ea0a53029e1f2e168f7d8b5beeca122938a54b50a09e2122d3de2cbd9fc |
|
MD5 | 7c15d63533e5b98a3eb18b25fa823518 |
|
BLAKE2b-256 | 0a9fb731ee25dc4b0c70e55a120873280ed355b1bd02d69976755035c9e7f071 |