🖼️ 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

🚀 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

⚡ 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:

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.

💻 Examples

🖼️ Image Converter

🔄 Convert PNG to WEBP

from imgtoolpro import converter

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

🗜️ Image Compression

from imgtoolpro import compressor

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

print(result)

✏️ Image Editor

🔄 Rotate an image

from imgtoolpro import editor

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

🎨 Image Filters

✨ Apply a filter to an image

from imgtoolpro import filters

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

🎞️ GIF Animation

🎬 Create a GIF from images

from imgtoolpro import animation

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

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, and 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.

⚙️ Requirements

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

• 🐍 Python 3.8 or higher
• 🖼️ Pillow 10.0.0 or higher
• 🎥 MoviePy (required for video/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

🎨 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!