{"id":48614917,"url":"https://github.com/gary19gts/hikari-image-compressor","last_synced_at":"2026-04-09T01:33:27.055Z","repository":{"id":319863373,"uuid":"1079858928","full_name":"gary19gts/hikari-image-compressor","owner":"gary19gts","description":"Free image compressor \u0026 optimizer for JPEG, PNG, WebP.  Batch compress photos with quality presets, format conversion  \u0026 resizing. Cross-platform Python GUI app.","archived":false,"fork":false,"pushed_at":"2025-10-30T15:23:39.000Z","size":86,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-30T17:28:33.755Z","etag":null,"topics":["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"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gary19gts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"gary19gts","custom":["https://ko-fi.com/gary19gts"]}},"created_at":"2025-10-20T13:50:32.000Z","updated_at":"2025-10-30T15:23:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"092f7f10-0997-4491-bc05-d561a1d8b236","html_url":"https://github.com/gary19gts/hikari-image-compressor","commit_stats":null,"previous_names":["gary19gts/hikari-image-compressor"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gary19gts/hikari-image-compressor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gary19gts%2Fhikari-image-compressor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gary19gts%2Fhikari-image-compressor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gary19gts%2Fhikari-image-compressor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gary19gts%2Fhikari-image-compressor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gary19gts","download_url":"https://codeload.github.com/gary19gts/hikari-image-compressor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gary19gts%2Fhikari-image-compressor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31581864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-04-09T01:33:26.093Z","updated_at":"2026-04-09T01:33:27.034Z","avatar_url":"https://github.com/gary19gts.png","language":"Python","funding_links":["https://ko-fi.com/gary19gts"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🌟 Hikari Image Compressor\n\n### Modern Image Compression Tool with Clean \u0026 Intuitive Interface\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/Gary19gts/hikari-image-compressor)\n[![Made with Love](https://img.shields.io/badge/Made%20with-❤️-red.svg)](https://github.com/Gary19gts)\n\n![Image](https://github.com/user-attachments/assets/55bb6226-cd2c-486f-83cc-fed72b0394ea)\n\n**Compress images effortlessly with a beautiful, intuitive interface designed for simplicity and power.**\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Screenshots](#-screenshots) • [Contributing](#-contributing) • [Support](#-support)\n\n\u003c/div\u003e\n\n---\n\n## 📖 About\n\n**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.\n\n### Why Hikari?\n\n- 🎨 **Beautiful UI** - Clean, modern design that's both elegant and functional\n- ⚡ **Fast \u0026 Efficient** - Batch process multiple images with real-time previews\n- 🔧 **Flexible Options** - Multiple quality presets, formats, and resize capabilities\n- 📊 **Smart Estimates** - See compression results before processing\n- 🆓 **100% Free** - Open source and always will be\n- 🌍 **Cross-Platform** - Works on Windows, macOS, and Linux\n\n---\n\n## ✨ Features\n\n### Core Functionality\n\n- **📁 Batch Processing** - Compress multiple images at once\n- **🖼️ Multiple Formats** - Support for JPEG, PNG, WebP, BMP, and TIFF\n- **🎚️ Quality Presets** - Choose from Low (30%), Medium (60%), High (80%), or Maximum (95%)\n- **📐 Smart Resizing** - Scale images by percentage while maintaining aspect ratio\n- **👁️ Live Preview** - See thumbnails and estimated compression before processing\n- **💾 Flexible Output** - Save to custom folder or same location as source\n\n### Advanced Features\n\n- **🔄 Format Conversion** - Convert between image formats during compression\n- **📊 Compression Estimates** - Real-time calculation of expected file sizes\n- **🎯 Transparency Handling** - Automatic RGBA to RGB conversion for JPEG\n- **⚙️ Multiple Engines** - Choose between Pillow and Imageio compression engines\n- **🗂️ Smart Naming** - Output files include quality and scale suffixes\n- **🚀 Non-Blocking UI** - Background processing keeps the interface responsive\n\n---\n\n## 🚀 Installation\n\n### Prerequisites\n\n- Python 3.8 or higher\n- pip (Python package manager)\n\n### Quick Install\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/Gary19gts/hikari-image-compressor.git\n   cd hikari-image-compressor\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Run the application**\n   ```bash\n   python hikari_image_compressor.py\n   ```\n\n### Dependencies\n\n```\ncustomtkinter\u003e=5.2.0\nPillow\u003e=10.0.0\nimageio\u003e=2.31.0\n```\n\n---\n\n## 💻 Usage\n\n### Basic Workflow\n\n1. **Load Images** - Click \"Select Images\" to choose files to compress\n2. **Configure Settings** - Adjust quality, format, and resize options\n3. **Preview** - Review thumbnails and estimated compression ratios\n4. **Select Output** - Choose where to save compressed images\n5. **Compress** - Click \"Start Compression\" and watch the magic happen!\n\n### Quality Guide\n\n| Quality Level | Use Case | Compression | Quality |\n|--------------|----------|-------------|---------|\n| **Low (30%)** | Thumbnails, previews | Maximum | Noticeable loss |\n| **Medium (60%)** | Web images, social media | High | Good balance |\n| **High (80%)** | General use, archiving | Moderate | Excellent ⭐ |\n| **Maximum (95%)** | Professional work | Minimal | Near-lossless |\n\n### Format Recommendations\n\n- **JPEG** - Best for photographs, no transparency support\n- **WebP** - Modern format, excellent compression, supports transparency\n- **PNG** - Lossless compression, transparency support, larger files\n\n### Resize Options\n\nScale images by percentage to reduce dimensions:\n- **50%** - Perfect for web optimization\n- **25%** - Ideal for thumbnails\n- **75%** - Moderate size reduction\n\n---\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### Main Interface\n\u003cimg src=\"https://via.placeholder.com/700x400/F8F9FA/1D1D1F?text=Main+Interface\" alt=\"Main Interface\" width=\"700\"/\u003e\n\n### Batch Processing\n\u003cimg src=\"https://via.placeholder.com/700x400/F8F9FA/1D1D1F?text=Batch+Processing\" alt=\"Batch Processing\" width=\"700\"/\u003e\n\n### Settings Panel\n\u003cimg src=\"https://via.placeholder.com/700x400/F8F9FA/1D1D1F?text=Settings+Panel\" alt=\"Settings Panel\" width=\"700\"/\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🛠️ Technical Details\n\n### Built With\n\n- **[Python](https://www.python.org/)** - Core programming language\n- **[CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)** - Modern UI framework\n- **[Pillow](https://pillow.readthedocs.io/)** - Image processing library\n- **[Imageio](https://imageio.readthedocs.io/)** - Advanced image I/O\n\n### Architecture\n\n- **Single-class design** for simplicity\n- **Threading** for non-blocking compression\n- **Event-driven UI** with real-time updates\n- **Cross-platform compatibility** with OS-specific optimizations\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Whether it's bug reports, feature requests, or code contributions, your help makes Hikari better.\n\n### How to Contribute\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### Development Setup\n\n```bash\n# Clone your fork\ngit clone https://github.com/YOUR_USERNAME/hikari-image-compressor.git\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run in development mode\npython hikari_image_compressor.py\n```\n\n---\n\n## 📝 License\n\nThis project is licensed under the **GNU Affero General Public License v3.0** - see the [LICENSE](LICENSE) file for details.\n\n### What this means:\n\n- ✅ Free to use, modify, and distribute\n- ✅ Open source forever\n- ✅ Commercial use allowed\n- ⚠️ Must disclose source code\n- ⚠️ Must use same license for derivatives\n- ⚠️ Network use requires source disclosure\n\n---\n\n## 🌟 Support\n\nThank you for using **Hikari Image Compressor**! Made with ❤️ by [Gary19gts](https://github.com/Gary19gts)\n\nIf Hikari has been helpful to you, please consider supporting its development:\n\n\u003cdiv align=\"center\"\u003e\n\n### ☕ Buy me a coffee on Ko-fi\n\n[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Development-FF5E5B?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/gary19gts)\n\n**✨ Even the smallest donation can bring a big light during these tough times.**\n\n**Even $1 can help more than you think 😀🙏**\n\n**Thank you so much for standing with me! ✨**\n\n\u003c/div\u003e\n\n### Other Ways to Support\n\n- ⭐ **Star this repository** - It helps others discover Hikari\n- 🐛 **Report bugs** - Help improve the software\n- 💡 **Suggest features** - Share your ideas\n- 📢 **Spread the word** - Tell others about Hikari\n- 🤝 **Contribute code** - Join the development\n\n---\n\n## 📞 Contact \u0026 Links\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub](https://img.shields.io/badge/GitHub-Gary19gts-181717?style=for-the-badge\u0026logo=github)](https://github.com/Gary19gts)\n[![Ko-fi](https://img.shields.io/badge/Ko--fi-gary19gts-FF5E5B?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/gary19gts)\n\n**Project Link:** [https://github.com/Gary19gts/hikari-image-compressor](https://github.com/Gary19gts/hikari-image-compressor)\n\n\u003c/div\u003e\n\n---\n\n## 🙏 Acknowledgments\n\nSpecial thanks to:\n\n- **[CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)** by Tom Schimansky - For the beautiful UI framework\n- **[Pillow](https://pillow.readthedocs.io/)** team - For powerful image processing\n- **Python Software Foundation** - For the amazing Python language\n- **Open Source Community** - For inspiration and support\n- **All contributors and users** - For making this project possible\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌟 If you find Hikari useful, please give it a star! 🌟\n\n**Made with ❤️ and ☕ by Gary19gts**\n\n*Bringing light to image compression, one pixel at a time.*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgary19gts%2Fhikari-image-compressor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgary19gts%2Fhikari-image-compressor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgary19gts%2Fhikari-image-compressor/lists"}