Skip to content

🖼️ Image Converter

This is a versatile Python project designed to streamline everyday workflows for basic to advanced image manipulation. It also serves as an excellent testbed for Google's AI code generation tools like Gemini and Jules! 🤖✨

(Note: All test images were generated by Google's Gemini service for testing purposes.)

✨ Features

  • ⛓️ Ordered, Chained Manipulations: Apply multiple manipulations to an image in a single command. The operations are executed in the exact order they are specified.
  • 🪄 Interactive Menu: Don't like remembering command line flags? Start the script with no arguments (or --menu) to launch a fully interactive UI to build your processing pipeline!
  • ✂️ Remove Background: Automatically removes the background from an image.
  • 📐 Scale & Resize: Resizes images by a specific factor (e.g., 2x) or to fit within given dimensions (e.g., 800px 600px). Supports various resampling filters.
  • 🎨 Image Filters & Adjustments:
  • Invert colors or convert to grayscale.
  • Adjust brightness, contrast, and saturation.
  • Adjust color balance (RGB channels) or rotate Hue.
  • Apply Edge Detection (Sobel, Canny, Kovalevsky).
  • Apply Gaussian Blur or Sharpening.
  • Posterize (reduce color depth).
  • 🔄 Transformations: Flip images (horizontally, vertically, or both), add borders, and rotate by 90-degree increments.
  • 💾 Advanced Exporting: Convert images native to modern formats like AVIF or HEIC, controlling export qualities individually or grouped. Includes options to flatten alpha transparency for formats that don't support it.
  • 📁 Batch Processing: Apply any of the above manipulations to a single image or to all images within a directory automatically.

🚀 Installation

  1. Clone the repository:

bash git clone https://github.com/dealien/Image-Converter.git cd Image-Converter

  1. Install the package and its requirements using pip:

bash pip install .