https://github.com/danielmorell/cruncher

Simple CLI app to optimize images for the web.
https://github.com/danielmorell/cruncher

compression cruncher images optimization python

Last synced: 22 days ago
JSON representation

Simple CLI app to optimize images for the web.

• Host: GitHub
• URL: https://github.com/danielmorell/cruncher
• Owner: danielmorell
• License: mit
• Created: 2019-09-27T06:23:35.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2022-08-18T15:35:12.000Z (about 2 years ago)
• Last Synced: 2024-10-02T08:14:07.797Z (about 1 month ago)
• Topics: compression, cruncher, images, optimization, python
• Language: Python
• Homepage: https://www.danielmorell.com/tools/cruncher
• Size: 84.7 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Cruncher

Cruncher is a simple but powerful command line tool that optimizes images for the web.

[![Version](https://flat.badgen.net/badge/PyPI/v0.4.0)](https://pypi.org/project/cruncher/)

## Installing

Install and update Cruncher using [pip](https://pip.pypa.io/en/stable/quickstart/).

```commandline

$ pip install cruncher

```

It is highly recommenced that you run Cruncher with [virualenv](https://virtualenv.pypa.io/en/latest/). This can abstract away the peculiarities of running Cruncher across multiple operating systems.

**Cruncher is built for Python 3.** It is tested the last three minor versions of Python (currently 3.8 to 3.10).

## Basic Usage

Cruncher is run from the terminal. Simply specify the image or directory of images you wish to compress, and your preferred settings.

**Example:**

```commandline

$ cruncher -i "C:\path_to_image\the_image.jpg" -q 75 -s 300 500 -o "C:\path_to_output_dir"

```

In this example the following options are used.

`-i` Is the path to the image you wish to compress.

`-q` Is the output image quality.

`-s` Is the output images dimensions (width, height).

`-o` Is the output directory.

Please read the documentation for more details about these options and the others that exist.

## Documentation

[Cruncher Documentation](https://www.danielmorell.com/tools/cruncher/documentation)

1. [Installation](https://www.danielmorell.com/tools/cruncher/documentation/installation)

1. [CLI Options](https://www.danielmorell.com/tools/cruncher/documentation/cli-options)

1. [JSON Configuration](https://www.danielmorell.com/tools/cruncher/documentation/json-configuration)

1. [ICC Profile Conversion](https://www.danielmorell.com/tools/cruncher/documentation/icc-profile-conversion)

1. [Troubleshooting](https://www.danielmorell.com/tools/cruncher/documentation/troubleshooting)

## Contributors

[@danielmorell](https://github.com/danielmorell)

Copyright © 2019-2022 [Daniel Morell](https://www.danielmorell.com/)