kaiso-imgcompressor 0.1.0

Fast offline image compressor for optimizing images under size constraints

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

pip install imgcompress

---

Usage

Basic Usage

imgcompress

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

---

Output Example

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.