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

🚀 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 image filters
• 🎯 Apply single or multiple filters

⚡ General Features

• 🧩 Easy-to-use functions
• 📂 Clean and organized project structure
• 💡 Lightweight and easy to integrate
• 🚀 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 image formats.

🗜️ Compressor

The compressor module provides tools for reducing image file size while keeping images practical and easy to use.

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

💻 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 Filters

✨ Apply a filter to an image

from imgtoolpro import filters

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

The converter module changes image formats, the compressor module reduces image file size, and the filters module applies filters and visual effects.

⚙️ Requirements

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

• 🐍 Python 3.8 or higher
• 🖼️ Pillow 10.0.0 or higher

🐍 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

🗜️ Image Compressor

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

🎨 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 conversion
• 📁 Output path validation
• 🎨 Automatic image mode handling (RGB, RGBA, LA, P)
• 🐍 Simple Python API
• 🖼️ Built with Pillow
• 🚀 Expandable architecture for adding new image processing features in future versions
• 🛡️ Safe error handling and input validation

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