imgcmprs

imgcmprs is a fast and safe command-line tool to efficiently compress JPEG and PNG images—supporting both lossless and lossy modes, for single files or entire directories.

🚀 Features

• Lossless & Lossy Compression: Supports both lossless and lossy compression for JPEG and PNG images.
• Batch & In-Place Modes: Process many files at once or compress in-place.
• Recursive Directory Processing: Optionally traverse and compress entire directory trees.
• CLI Simplicity: Intuitive command-line interface with helpful flags.
• Safe by Design: Original files are always preserved unless you choose to delete them post-compression.

📦 Installation

Python 3.7+ is required.

Install from PyPI:

pip install imgcmprs

Install from source (in editable or user-local mode):

pip install -e .
# Or
pip install --user .

🤝 Contributing

We welcome all contributions! To get started:

1. Fork this repository on GitHub.
2. Clone your fork and create a feature branch.
3. Implement your changes, write clear commit messages, and add tests if possible.
4. Open a pull request with a thorough description of what you've changed.

For bug reports or feature requests, please open an issue.

Thank you for making imgcmprs better!

— Made with ❤️ by Eyad Mohammed, from Egypt