Skip to main content

Fast, safe CLI to compress JPEG & PNG, lossless/lossy, batch or single images.

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imgcmprs-0.1.2.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imgcmprs-0.1.2-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file imgcmprs-0.1.2.tar.gz.

File metadata

  • Download URL: imgcmprs-0.1.2.tar.gz
  • Upload date:
  • Size: 4.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for imgcmprs-0.1.2.tar.gz
Algorithm Hash digest
SHA256 d9a4e6852df00fe6dc41a642b2ad26cf51cab2a44b8280b64ed1b937fcab6ae0
MD5 ee83438811d56bfb6e4b3df08ceda23e
BLAKE2b-256 af3974b73c55868ed07a8b36166bc65a74c126cf90be37267be6a1caeee1385a

See more details on using hashes here.

File details

Details for the file imgcmprs-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: imgcmprs-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for imgcmprs-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bcfad7c6b99e311a67392521b1c235ad4d254231c4304f580808c8b483cffa4c
MD5 7d6f9261dce24d2e5322369ec690ee5c
BLAKE2b-256 08a3b284c341677bc999ebb7b7dec3405939521cd301efe25290fb96c4364a8e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page