🖼️ InteliComp

Intelligent Image Compression Tool

A modern, feature-rich GUI application for intelligent image compression with real-time preview and batch processing capabilities.

---

✨ Features

🎛️ Quality Control

• Intuitive Quality Slider - Adjust compression quality from 1-100%
• Quick Presets - One-click quality presets (Low, Medium, High, Best)
• Real-time Preview - See compression results instantly as you adjust settings

🖼️ Format Support

• Input Formats: JPEG, PNG, WebP, BMP, TIFF, HEIC/HEIF
• Output Formats: JPEG, PNG, WebP (with format conversion)
• Smart Handling - Automatic format detection and optimization

📦 Batch Processing

• Multi-file Compression - Process hundreds of images at once
• Parallel Processing - Utilizes multiple CPU cores for speed
• Progress Tracking - Real-time progress with cancellation support

🎨 Image Resizing

• Maximum Dimensions - Set max width/height constraints
• Aspect Ratio - Maintain or ignore original proportions
• Smart Scaling - High-quality Lanczos resampling

⚙️ Advanced Options

• Lossless Compression - Zero quality loss for PNG and WebP formats
• Progressive JPEG - Create progressive-loading JPEGs
• PNG Optimization - Enhanced PNG compression
• Metadata Control - Option to preserve or strip EXIF data

🌓 Modern UI

• Dark/Light Theme - Toggle between themes with one click
• Side-by-side Preview - Compare original vs compressed
• Detailed Statistics - File size, dimensions, and savings displayed

---

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/InteliComp.git
   cd InteliComp

2. Create a virtual environment (recommended)

   python -m venv venv
   
   # On Windows
   venv\Scripts\activate
   
   # On macOS/Linux
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

4. Run the application

   python run.py

---

📖 Usage Guide

Single Image Compression

1. Click "Add Files" or "Add Folder" to load images
2. Select an image from the file list
3. Adjust the Quality slider and watch the real-time preview
4. Configure additional settings as needed
5. Click "Save Compressed" to save the optimized image

Batch Compression

1. Add multiple images using "Add Files" or "Add Folder"
2. Configure your desired compression settings
3. Click "Compress All Files"
4. Select an output folder
5. Monitor progress and wait for completion

Understanding the Preview

• Left Panel: Shows the original image with its properties
• Right Panel: Shows real-time preview of compressed result
• Bottom Bar: Displays size comparison and savings percentage

---

⚙️ Configuration Options

Setting	Description	Default
Quality	Compression quality (1-100%)	85%
Output Format	Target format (Original/JPEG/PNG/WebP)	Original
Lossless	Enable lossless compression (PNG/WebP)	Off
Resize	Enable dimension constraints	Off
Max Width	Maximum output width in pixels	1920
Max Height	Maximum output height in pixels	1080
Maintain Aspect Ratio	Keep original proportions	On
Progressive JPEG	Create progressive JPEGs	On
Optimize PNG	Extra PNG optimization	On
Preserve Metadata	Keep EXIF and other metadata	Off

Note on Lossless Compression:

• PNG: Always lossless by nature
• WebP: Full lossless mode supported
• JPEG: Uses maximum quality (100%) - not true lossless as JPEG is inherently lossy

---

🏗️ Project Structure

InteliComp/
├── run.py              # Application entry point
├── requirements.txt    # Python dependencies
├── README.md          # This file
├── LICENSE            # MIT License
├── src/
│   ├── __init__.py    # Package initialization
│   ├── app.py         # Main GUI application
│   └── compressor.py  # Image compression engine
└── docs/
    └── screenshot.png # Application screenshot

---

🛠️ Development

Running Tests

python -m pytest tests/

Building Standalone Executable

You can create a standalone executable using PyInstaller:

pip install pyinstaller
pyinstaller --onefile --windowed --name InteliComp run.py

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📋 Roadmap

• Drag and drop support for files
• Image format conversion tools
• Custom compression profiles
• Command-line interface (CLI)
• Plugin system for additional formats
• Cloud storage integration
• Watermark support
• Image comparison slider

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• CustomTkinter - Modern UI framework
• Pillow - Image processing library
• pillow-heif - HEIC/HEIF support

---

Made with ❤️ by the InteliComp Team

Report Bug · Request Feature