Metadata-Version: 2.4
Name: imgtoolpro
Version: 3.4.1
Summary: A Python image processing toolkit for converting, compressing, filtering, editing images, inspecting images, and creating GIF animations with advanced image processing features.
Author: karan.rf
License: MIT License
        
        Copyright (c) 2026 karan.rf
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
Keywords: image,image-processing,image-converter,image-compressor,image-filters,image-editor,image-inspector,image-analysis,image-metadata,exif,image-animation,gif,gif-animation,animation,gif-maker,video-to-gif,gif-to-video,editor,converter,compressor,filters,inspector,resize,crop,rotate,watermark,pillow,python,jpg,jpeg,png,webp,tiff
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: moviepy>=2.0.0
Requires-Dist: imageio>=2.34.0
Requires-Dist: imageio-ffmpeg>=0.5.1
Dynamic: license-file

# 🖼️ imgtoolpro

> ✨🖼️ A Python image processing toolkit for simple and practical image operations.

---

# 📖 Introduction

**imgtoolpro** is a Python library designed to provide useful and easy-to-use tools for working with images.

The goal of this project is to create a lightweight and expandable toolkit that allows developers to perform common image-related tasks with a simple and organized structure.

The library is designed to grow over time by adding more image processing features and utilities.

---

# ✨ Current Features

### 📦 Modules

- 🖼️ Converter Module
- 🗜️ Compressor Module
- 🎨 Filters Module
- ✏️ Editor Module
- 🎞️ Animation Module
- 🔍 Inspector Module

### 🚀 Converter Features

- 🔄 Convert images between **13 supported formats**
- 🔍 Automatic image format detection
- 📋 Supported formats list
- ✅ Image validation before conversion
- 📁 Output path validation
- 🎨 Automatic handling of **RGB, RGBA, LA and P** image modes

### 🗜️ Compressor Features

- 📦 Compress images to a custom target file size
- 🎯 Default target size: **500 KB**
- ⚙️ Adjustable `target_kb` parameter
- 🖼️ Supports **JPG, JPEG, PNG, GIF, TIFF and WebP**
- 📉 Automatic quality optimization
- 📊 Returns compression information:
  - 📏 Original size
  - 📉 Final size
  - 💾 Saved size
  - 📈 Reduction percentage
  - 🎚️ Final quality
  - 🖼️ Image dimensions
- 🛡️ Built-in error handling

### 🎨 Filters Features

- 🖌️ 23 built-in image filters
- 🎯 Apply single or multiple filters

### ✏️ Editor Features

- 📐 Resize and scale images
- ✂️ Crop images in multiple ways
- 🔄 Rotate and flip images
- 🎨 Adjust brightness, contrast, saturation and sharpness
- 🖌️ Draw text and shapes on images
- 🖼️ Overlay, merge and combine images
- 💧 Add text or image watermarks
- 🧹 Remove or replace simple backgrounds
- 🖼️ Add borders, frames and rounded corners
- 🔧 Automatic image enhancement and noise reduction
- 📊 Image information and utility functions
- 💾 Automatic image saving with output validation
- 🛡️ Built-in error handling and input validation

### 🎞️ Animation Features

- 🎬 Create GIF animations from multiple images
- 🖼️ Extract frames from GIF files
- 📊 Get complete GIF information:
  - 📏 Image dimensions
  - 🎞️ Frame count
  - ⏱️ Frame durations
  - 🔁 Loop information
  - 💾 File size information
- ⚡ Change GIF animation speed
- 🔄 Reverse GIF animations
- 🧩 Merge multiple GIF files into one animation
- ✏️ Add animated text to GIF files
- 🖼️ Create moving image animations
- 🎥 Convert videos to GIF animations
- 🎬 Convert GIF animations to MP4 videos
- 📐 Automatic frame size normalization
- 🎨 Support for RGBA and transparent images
- 🛡️ Built-in validation and error handling

# 🔍 Inspector Module Features

- 📋 Get complete image information

## 📁 File Information

- 📄 Get file name
- 📂 Get absolute file path
- 📏 Get file size in bytes and readable format
- 🏷️ Get file extension
- 🌐 Get MIME type
- 🕒 Get:
  - Creation time
  - Modification time
  - Last access time


## 🖼️ Image Information

- 📐 Get image width and height
- 🔢 Calculate total pixel count
- 🎨 Detect image color mode
- 🌈 Get number of color channels
- 📏 Calculate aspect ratio
- 🔢 Get image bit depth
- 🖼️ Detect image format


## 🎨 Color Analysis

- 🌈 Calculate average color
- 🎯 Extract dominant colors
- 📊 Get color histogram
- 🔢 Count unique colors
- ☀️ Calculate brightness
- ⚖️ Calculate contrast
- 🌈 Calculate saturation


## 💧 Transparency Information

- 🔍 Detect alpha channel
- 🖼️ Detect image transparency
- 🔢 Count transparent pixels
- 📊 Get complete transparency information


## 📷 EXIF Information

- 📋 Get complete EXIF metadata
- 📸 Detect camera manufacturer
- 📷 Detect camera model
- 🔭 Get lens information
- 🎯 Get focal length
- ⚙️ Get ISO value
- 🌗 Get aperture value
- ⏱️ Get shutter speed
- 💡 Get flash information
- 📅 Get original capture date
- 🌍 Get GPS information and coordinates


## 🎞️ Animation Information

- 🎬 Detect animated images
- 🖼️ Get frame count
- ⏱️ Get total animation duration
- ⚡ Calculate animation FPS
- 🔁 Get loop count


## ✅ Image Validation

- ✔️ Check image validity
- 🔍 Detect corrupted images
- 📂 Check if image can be opened safely
- 🛡️ Safe validation handling


## 🎨 Advanced Information

- 🌈 Detect ICC color profile
- 🗜️ Get compression information
- 🎚️ Get JPEG quality information
- 💾 Estimate image memory usage

### ⚡ General Features

- 🧩 Easy-to-use functions
- 📂 Clean and organized project structure
- 💡 Lightweight and easy to integrate
- 🛡️ Built-in error handling and input validation
- 🔍 Automatic file and format validation
- 🎨 Support for multiple image modes
- 🚀 Expandable design for future features

---

# 📚 About The Project

**imgtoolpro** is created with simplicity and flexibility in mind.

The library is designed to provide practical image processing tools with a clean and simple structure, making it easy to integrate into different Python projects.

The project architecture allows new modules and features to be added in future versions.

---

# 📦 Installation

Install **imgtoolpro** using **pip**:

```bash
pip install imgtoolpro
```

---

# 📂 Modules

## 🖼️ Converter

The **converter** module provides tools for converting images between supported formats with automatic format detection and built-in validation.

---

## 🗜️ Compressor

The **compressor** module provides tools for reducing image file size while keeping images practical and easy to use with customizable compression settings.

---

## 🎨 Filters

The **filters** module provides tools for applying built-in image filters, enhancing image appearance, and creating various visual effects with a simple and practical interface.

---

## ✏️ Editor

The **editor** module provides comprehensive image editing tools, including resizing, cropping, rotating, drawing, watermarking, background editing, image composition, and various utilities through a simple and easy-to-use interface.

---

## 🎞️ Animation

The **animation** module provides tools for creating and editing GIF animations, including GIF creation, frame extraction, speed control, reversing, merging, animated text, image movement, and GIF/video conversion.

---

## 🔍 Inspector

The **inspector** module provides tools for analyzing and extracting detailed information from images, including file information, image properties, color analysis, transparency detection, EXIF metadata, animation details, validation checks, and advanced image information through a simple and reliable interface.

---

# 💻 Examples

## 🖼️ Image Converter

### 🔄 Convert PNG to WEBP

```python
from imgtoolpro import converter

converter.convert_image(
    "input.png",
    "output.webp"
)
```

---

### 🗜️ Image Compression

```python
from imgtoolpro import compressor

result = compressor.compress(
    "input.jpg",
    "output.jpg",
    target_kb=500
)

print(result)
```

---

## ✏️ Image Editor

### 🔄 Rotate an image

```python
from imgtoolpro import editor

editor.rotate(
    "input.jpg",
    "output.jpg",
    90
)
```

---

## 🎨 Image Filters

### ✨ Apply a filter to an image

```python
from imgtoolpro import filters

filters.apply_filter(
    "input.jpg",
    "filtered.jpg",
    "blur"
)
```

---

## 🎞️ GIF Animation

### 🎬 Create a GIF from images

```python
from imgtoolpro import animation

animation.create_gif(
    [
        "frame1.png",
        "frame2.png",
        "frame3.png"
    ],
    "output.gif",
    duration=500
)

```

---

## 🔍 Image Inspector

### 📋 Get complete image information

```python
from imgtoolpro import inspector

info = inspector.inspect(
    "image.jpg"
)

print(info)

```

---

The **converter** module changes image formats, the **compressor** module reduces image file size, the **filters** module applies filters and visual effects, the **editor** module provides comprehensive image editing tools such as resizing, cropping, rotating, drawing, watermarking, and image composition, the **animation** module provides tools for creating and editing GIF animations, including GIF creation, frame extraction, speed control, reversing, merging, animated text, image movement, and GIF/video conversion and the **inspector** module provides tools for analyzing images and extracting detailed information such as file properties, image details, color analysis, transparency information, EXIF metadata, animation details, and validation results.

---

# ⚙️ Requirements

Before using **imgtoolpro**, make sure your environment meets the following requirements:

- 🐍 Python **3.8** or higher
- 🖼️ Pillow **10.0.0** or higher
- 🔢 NumPy (required for image frame processing)
- 🎥 MoviePy (required for video and GIF conversion features)
- 🎬 imageio and imageio-ffmpeg (required for video processing)

---

# 🐍 Supported Python Versions

Currently supported versions:

- ✅ Python 3.8
- ✅ Python 3.9
- ✅ Python 3.10
- ✅ Python 3.11
- ✅ Python 3.12
- ✅ Python 3.13

---

# 🌟 Features Overview

**imgtoolpro** provides simple and practical tools for common image processing tasks.

The library includes organized modules that allow developers to work with images easily and efficiently.

---

# 🚀 Features Overview

## 🖼️ Image Processing Features

- 🔄 Image format conversion support
- 🖼️ Convert images between **13 supported formats**
- 🗜️ Image compression support
- 🎨 Advanced image filtering system
- ✏️ Comprehensive image editing tools

---

### 🗜️ Image Compressor

- 📉 Reduce image file size
- 🎯 Control target output size
- ⚡ Fast image compression

---

### ✏️ Image Editor

- 📐 Resize and scale images
- ✂️ Crop images in multiple ways
- 🔄 Rotate and flip images
- 🎨 Adjust colors and image appearance
- 🖌️ Draw text and shapes
- 🖼️ Overlay, merge, and combine images
- 💧 Add watermarks and logos
- 🧹 Remove or replace simple backgrounds
- 🖼️ Add borders, frames, and rounded corners
- 🔧 Automatic image enhancement and utilities

---

### 🎞️ GIF Animation

- 🎬 Create GIF animations from multiple images
- 🖼️ Extract frames from GIF files
- 📊 Get GIF information and frame details
- ⚡ Change GIF animation speed
- 🔄 Reverse GIF animations
- 🧩 Merge multiple GIF files
- ✏️ Add animated text to GIFs
- 🖼️ Create moving image animations
- 🎥 Convert videos to GIF
- 🎬 Convert GIF animations to videos

---

### 🔍 Image Inspector

- 📋 Get complete image information
- 📁 Analyze file information:
  - 📄 File name
  - 📂 File path
  - 📏 File size
  - 🏷️ File extension
  - 🌐 MIME type
  - 🕒 File timestamps

- 🖼️ Analyze image properties:
  - 📐 Width and height
  - 🔢 Pixel count
  - 🎨 Color mode
  - 🌈 Color channels
  - 📏 Aspect ratio
  - 🔢 Bit depth

- 🎨 Analyze image colors:
  - 🌈 Average color
  - 🎯 Dominant colors
  - 📊 Histogram
  - 🔢 Unique colors
  - ☀️ Brightness
  - ⚖️ Contrast
  - 🌈 Saturation

- 💧 Detect transparency information:
  - 🔍 Alpha channel
  - 🖼️ Transparency detection
  - 🔢 Transparent pixel count

- 📷 Extract EXIF metadata:
  - 📸 Camera information
  - 🔭 Lens information
  - 🎯 Focal length
  - ⚙️ ISO
  - ⏱️ Shutter speed
  - 💡 Flash information
  - 🌍 GPS coordinates

- 🎞️ Analyze animation details:
  - 🎬 Animated image detection
  - 🖼️ Frame count
  - ⏱️ Duration
  - ⚡ FPS
  - 🔁 Loop information

- ✅ Validate images:
  - ✔️ Check image validity
  - 🔍 Detect corrupted images
  - 📂 Check opening capability

- 🌈 Get advanced image information:
  - 🎨 ICC profile
  - 🗜️ Compression information
  - 💾 Memory usage estimation

## 🎨 23 Built-in Image Filters

- 🌫️ blur
- 🌀 gaussian_blur
- 🖊️ contour
- 🔍 detail
- ✨ edge_enhance
- ⚡ edge_enhance_more
- 🪙 emboss
- 📐 find_edges
- 🌊 smooth
- 💧 smooth_more
- 🔪 sharp
- ⚫ grayscale
- 🔄 invert
- 🌅 sepia
- ☀️ brightness
- 🌗 contrast
- 🎭 cartoon
- 🤖 auto_enhance
- 🎨 replace_color
- 🟪 pixelate
- 🌑 vignette
- 📺 noise
- 🌡️ color_temperature

---

## ⚙️ Additional Features

- 🎯 Apply single or multiple filters
- 📋 Filter information and filter list support
- 🔍 Automatic image format detection
- 📄 Supported formats list
- ✅ Image validation before processing
- 📁 Output path validation
- 🎨 Automatic image mode handling (**RGB, RGBA, LA and P**)
- 💾 Automatic image saving
- 🛡️ Safe error handling and input validation
- 🐍 Simple Python API
- 🖼️ Built with Pillow
- 🚀 Expandable architecture for adding new image processing features in future versions

---

# 💻 Compatibility

**imgtoolpro** is designed to work on operating systems that support Python, including:

- 🪟 Windows
- 🐧 Linux
- 🍎 macOS

---

# 📈 Project Status

🛠️ **imgtoolpro** is currently under active development.

✨ New features, improvements, and optimizations will be added in future releases.

---

# 👨‍💻 Author

**Created by:** `karan.rf`

---

⭐ **Thank you for using imgtoolpro!**
