Skip to content

v0.1.1

Choose a tag to compare

@mricardo888 mricardo888 released this 11 Apr 21:58
· 9 commits to main since this release

πŸ“¦ Release: v0.1.1 – Official Initial Release

ImageConvert is a Python library for converting images across a wide variety of formats while preserving essential metadata and file timestamps.


πŸš€ Highlights in v0.1.1:

  • Supported Formats:

    • JPEG (.jpg, .jpeg)
    • PNG (.png)
    • BMP (.bmp)
    • TIFF (.tiff, .tif)
    • WebP (.webp)
    • SVG (.svg)
    • RAW (.raw)
    • HEIF/HEIC (.heif, .heic)
  • Core Features:

    • πŸ”„ Image conversion with support for EXIF and timestamp preservation.
    • 🧠 EXIF metadata extraction and re-embedding (including camera data, GPS, etc.)
    • πŸ“‚ Batch conversion with directory recursion.
    • πŸ•’ Preserves file creation, modification, and access times.
    • 🧭 EXIF GPS location parsing with human-readable output.
    • πŸ” Detailed image info retrieval, including format, size, DPI, camera info, and more.

⚠️ Not Yet Supported:

  • Saving to .heif, .heic, .svg, and .raw formats (reading only).
  • Advanced metadata editing beyond preservation.

πŸ“˜ Example Usage:

from imageconvert import ImageConvert

# Convert a single image
ImageConvert.convert("photo.heic", "photo.png")

# Batch convert an entire folder to .jpg
ImageConvert.batch_convert("images/", "converted/", ".jpg")

# Get metadata info of an image
info = ImageConvert.get_image_info("photo.jpg")
print(info["camera"], info.get("gps"))

For full documentation and examples, please refer to the README or visit the GitHub repository.