Metadata-Version: 2.4
Name: kaiso-imgcompressor
Version: 0.1.0
Summary: Fast offline image compressor for optimizing images under size constraints
Author: Pramit Acharjya
License: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow
Dynamic: license-file

# ImgCompress

A fast, offline image compression library designed to optimize images under a size constraint while preserving maximum possible quality.

---

## Features

* Adaptive quality optimization (maintains best possible quality)
* Supports multiple formats (JPG, PNG, BMP, GIF)
* Multi-threaded processing for faster batch compression
* Batch image selection support
* Automatic temporary file handling

---

## Installation

```bash
pip install imgcompress
```

---

## Usage

### Basic Usage

```bash
imgcompress
```

* Opens a file dialog to select images
* Prompts for output directory
* Compresses images automatically

---

### Output Example

```text
Image Compression Complete
Images saved at: C:\Users\YourName\Pictures

Compression sizes compared to original:

Image                          Original (MB)   Compressed (MB)
------------------------------------------------------------
thumbnail.png                  : 5.20 -> 1.85
banner.jpg                     : 3.10 -> 1.92
```

---

## How It Works

1. Loads selected images
2. Resizes images (max 1280×720)
3. Converts to JPEG format
4. Iteratively reduces quality
5. Stops at the **highest quality under 2MB**

---

## Supported Formats

* `.jpg`
* `.jpeg`
* `.png`
* `.bmp`
* `.gif`

(All outputs are saved as optimized JPEG files)

---

## Notes

* Images already under 2MB are skipped
* Output images are compressed and may overwrite existing files if names match
* Best suited for thumbnails, web images, and quick optimization tasks

---

## Contributing

Contributions are welcome!
Feel free to open issues or submit pull requests.

---

## License

GNU LICENSE

---

## Author

Built as a practical utility tool for fast and efficient image compression.
