Metadata-Version: 2.4
Name: imgcmprs
Version: 0.1.2
Summary: Fast, safe CLI to compress JPEG & PNG, lossless/lossy, batch or single images.
Author: Eyad Mohammed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: Pillow
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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:
```bash
pip install imgcmprs
```

Install from source (in editable or user-local mode):
```bash
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](https://github.com/jackgawe/imgcmprs/issues).

Thank you for making **imgcmprs** better!
  
— Made with ❤️ by Eyad Mohammed, from Egypt
