Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/gary19gts/hikari-image-compressor

Free image compressor & optimizer for JPEG, PNG, WebP. Batch compress photos with quality presets, format conversion & resizing. Cross-platform Python GUI app.
https://github.com/gary19gts/hikari-image-compressor

compress-images cross-platform desktop-application gui-application image-compression image-compressor image-optimizer image-processing jpeg-compression jpeg-compressor jpg-compression jpg-compressor mass-image-compression photo-compression png-compression png-compressor png-optimizer python webp

Last synced: about 2 months ago
JSON representation

Free image compressor & optimizer for JPEG, PNG, WebP. Batch compress photos with quality presets, format conversion & resizing. Cross-platform Python GUI app.

Awesome Lists containing this project

README 

          



# 🌟 Hikari Image Compressor



### Modern Image Compression Tool with Clean & Intuitive Interface



[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/Gary19gts/hikari-image-compressor)

[![Made with Love](https://img.shields.io/badge/Made%20with-❤️-red.svg)](https://github.com/Gary19gts)



![Image](https://github.com/user-attachments/assets/55bb6226-cd2c-486f-83cc-fed72b0394ea)



**Compress images effortlessly with a beautiful, intuitive interface designed for simplicity and power.**



[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Screenshots](#-screenshots) • [Contributing](#-contributing) • [Support](#-support)






---



## 📖 About



**Hikari Image Compressor** (光 - meaning "light" in Japanese) is a free, open-source desktop application that makes image compression simple and elegant. Whether you're optimizing photos for the web, reducing file sizes for storage, or preparing images for social media, Hikari provides powerful compression tools wrapped in a clean, modern interface.



### Why Hikari?



- 🎨 **Beautiful UI** - Clean, modern design that's both elegant and functional

- ⚡ **Fast & Efficient** - Batch process multiple images with real-time previews

- 🔧 **Flexible Options** - Multiple quality presets, formats, and resize capabilities

- 📊 **Smart Estimates** - See compression results before processing

- 🆓 **100% Free** - Open source and always will be

- 🌍 **Cross-Platform** - Works on Windows, macOS, and Linux



---



## ✨ Features



### Core Functionality



- **📁 Batch Processing** - Compress multiple images at once

- **🖼️ Multiple Formats** - Support for JPEG, PNG, WebP, BMP, and TIFF

- **🎚️ Quality Presets** - Choose from Low (30%), Medium (60%), High (80%), or Maximum (95%)

- **📐 Smart Resizing** - Scale images by percentage while maintaining aspect ratio

- **👁️ Live Preview** - See thumbnails and estimated compression before processing

- **💾 Flexible Output** - Save to custom folder or same location as source



### Advanced Features



- **🔄 Format Conversion** - Convert between image formats during compression

- **📊 Compression Estimates** - Real-time calculation of expected file sizes

- **🎯 Transparency Handling** - Automatic RGBA to RGB conversion for JPEG

- **⚙️ Multiple Engines** - Choose between Pillow and Imageio compression engines

- **🗂️ Smart Naming** - Output files include quality and scale suffixes

- **🚀 Non-Blocking UI** - Background processing keeps the interface responsive



---



## 🚀 Installation



### Prerequisites



- Python 3.8 or higher

- pip (Python package manager)



### Quick Install



1. **Clone the repository**

   ```bash

   git clone https://github.com/Gary19gts/hikari-image-compressor.git

   cd hikari-image-compressor

   ```



2. **Install dependencies**

   ```bash

   pip install -r requirements.txt

   ```



3. **Run the application**

   ```bash

   python hikari_image_compressor.py

   ```



### Dependencies



```

customtkinter>=5.2.0

Pillow>=10.0.0

imageio>=2.31.0

```



---



## 💻 Usage



### Basic Workflow



1. **Load Images** - Click "Select Images" to choose files to compress

2. **Configure Settings** - Adjust quality, format, and resize options

3. **Preview** - Review thumbnails and estimated compression ratios

4. **Select Output** - Choose where to save compressed images

5. **Compress** - Click "Start Compression" and watch the magic happen!



### Quality Guide



| Quality Level | Use Case | Compression | Quality |

|--------------|----------|-------------|---------|

| **Low (30%)** | Thumbnails, previews | Maximum | Noticeable loss |

| **Medium (60%)** | Web images, social media | High | Good balance |

| **High (80%)** | General use, archiving | Moderate | Excellent ⭐ |

| **Maximum (95%)** | Professional work | Minimal | Near-lossless |



### Format Recommendations



- **JPEG** - Best for photographs, no transparency support

- **WebP** - Modern format, excellent compression, supports transparency

- **PNG** - Lossless compression, transparency support, larger files



### Resize Options



Scale images by percentage to reduce dimensions:

- **50%** - Perfect for web optimization

- **25%** - Ideal for thumbnails

- **75%** - Moderate size reduction



---



## 📸 Screenshots






### Main Interface

Main Interface



### Batch Processing

Batch Processing



### Settings Panel

Settings Panel






---



## 🛠️ Technical Details



### Built With



- **[Python](https://www.python.org/)** - Core programming language

- **[CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)** - Modern UI framework

- **[Pillow](https://pillow.readthedocs.io/)** - Image processing library

- **[Imageio](https://imageio.readthedocs.io/)** - Advanced image I/O



### Architecture



- **Single-class design** for simplicity

- **Threading** for non-blocking compression

- **Event-driven UI** with real-time updates

- **Cross-platform compatibility** with OS-specific optimizations



---



## 🤝 Contributing



Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, your help makes Hikari better.



### How to Contribute



1. Fork the repository

2. Create a 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



### Development Setup



```bash

# Clone your fork

git clone https://github.com/YOUR_USERNAME/hikari-image-compressor.git



# Create virtual environment

python -m venv venv

source venv/bin/activate  # On Windows: venv\Scripts\activate



# Install dependencies

pip install -r requirements.txt



# Run in development mode

python hikari_image_compressor.py

```



---



## 📝 License



This project is licensed under the **GNU Affero General Public License v3.0** - see the [LICENSE](LICENSE) file for details.



### What this means:



- ✅ Free to use, modify, and distribute

- ✅ Open source forever

- ✅ Commercial use allowed

- ⚠️ Must disclose source code

- ⚠️ Must use same license for derivatives

- ⚠️ Network use requires source disclosure



---



## 🌟 Support



Thank you for using **Hikari Image Compressor**! Made with ❤️ by [Gary19gts](https://github.com/Gary19gts)



If Hikari has been helpful to you, please consider supporting its development:






### ☕ Buy me a coffee on Ko-fi



[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Development-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/gary19gts)



**✨ Even the smallest donation can bring a big light during these tough times.**



**Even $1 can help more than you think 😀🙏**



**Thank you so much for standing with me! ✨**






### Other Ways to Support



- ⭐ **Star this repository** - It helps others discover Hikari

- 🐛 **Report bugs** - Help improve the software

- 💡 **Suggest features** - Share your ideas

- 📢 **Spread the word** - Tell others about Hikari

- 🤝 **Contribute code** - Join the development



---



## 📞 Contact & Links






[![GitHub](https://img.shields.io/badge/GitHub-Gary19gts-181717?style=for-the-badge&logo=github)](https://github.com/Gary19gts)

[![Ko-fi](https://img.shields.io/badge/Ko--fi-gary19gts-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/gary19gts)



**Project Link:** [https://github.com/Gary19gts/hikari-image-compressor](https://github.com/Gary19gts/hikari-image-compressor)






---



## 🙏 Acknowledgments



Special thanks to:



- **[CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)** by Tom Schimansky - For the beautiful UI framework

- **[Pillow](https://pillow.readthedocs.io/)** team - For powerful image processing

- **Python Software Foundation** - For the amazing Python language

- **Open Source Community** - For inspiration and support

- **All contributors and users** - For making this project possible



---






### 🌟 If you find Hikari useful, please give it a star! 🌟



**Made with ❤️ and ☕ by Gary19gts**



*Bringing light to image compression, one pixel at a time.*