John MacDonald

reSmush.it Image Optimizer CLI client

CLI client for the reSmush.it Image Optimization API

What is reSmush.it ?

Use reSmush.it Image Optimizer for FREE to optimize your pictures file sizes. Improve your performances by using reSmush.it, the 3 billion images API optimizer.

reSmush.it Image Optimizer allow to use free Image optimization based on reSmush.it API. reSmush.it provides image size reduction based on several advanced algorithms. The API accept JPG, PNG and GIF files up to 5MB.

What is this tool ?

This tool allow you to perform a powerful optimization of one or multiple pictures using a bash (command line) script based on the reSmush.it API.

Getting Started

This tool can optimize on or several pictures. The recursive option is not yet implemented

1. Download the tool using a git clone command on your computer/server
2. Make the file resmushit-cli.sh executable using the following command : chmod +x resmushit-cli.sh
3. Run the optimizer by typing command ./resmushit-cli.sh myfile.jpg

Prerequisites

This will require to be executed on a Linux based Operating System (Linux or MacOS). The following packages must be installed on the system

• curl
• jq (see jq Homepage)

Install on your system

If you’re using a Linux system (Debian, CentOS…) you can install after cloning from the GIT repo by typing the following command as root user (or using sudo) :

• mv resmushit-cli.sh /usr/bin/resmushit;chmod +x /usr/bin/resmushit

Your CLI optimizer will be available everywhere in your server/computer by typing resmushit

Usage example

Replace in the examples below resmushit by ./resmushit-cli.sh if you haven’t installed the optimizer globally on your machine.

Optimize a picture and create a new optimized picture file

resmushit mypicture.jpg

The optimized file will be named mypicture-optimized.jpg

Optimize a picture and replace the original file

resmushit mypicture.jpg --preserve-filename

Optimize a picture and set a optimization factor

resmushit -q 92 mypicture.jpg

Optimize multiple pictures and export them into a folder

resmushit --output myexportdirectory/ *

Optimize a picture and preserve its EXIF data

resmushit mypicture.jpg --preserve-exif

Options

• -h or --help : display the help menu
• -v or --version : display the current version of reSmushit CLI client
• -q <quality> or --quality <quality> : specify the quality factor between 0 and 100 (default is 92).
• -o <directory> or --output <directory> : specify an output directory (will be created if not present)
• --preserve-filename : avoid to add -optimized in the filename when the image is optimized
• --preserve-exif : will preserve EXIF data in the file after optimization
• --notime : avoid to display timer in output
• --quiet : run in quiet mode
• --update : perform an auto-upgrade process

Bugs

All bugs should be reported to : hello@resmush.it

Roadmap

• Add “preserve filename” option
• Add EXIF preservation option
• Add progress bar mode
• Add support of recursive optimization
• Add an installer mode
• Add an auto-update method based on Git repo
• Avoid sending to API if file is > 5MB

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Charles Bourgeaux - Initial work - reSmush.it

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Support on Beerpay

Help us by paying us a couple of !

Changelog

v1.0.8 (build 20190122)

• Fix an issue for filenames with spaces
• Better check for the update temporary file writeability

v1.0.7 (build 20181222)

• Better update check and upgrade minor fix

v1.0.6 (build 20181222)

• Check if file is > 5MB before sending it to the API

v1.0.5 (build 20180819)

• Minor update bugfix

v1.0.4 (build 20180819)

• Add an update verification
• Add an auto-upgrade process

v1.0.3 (build 20180818)

• Adding EXIF preservation support
• Add a verification is file specified exists
• Correction for the filename non-preservation by default

v1.0.2 (build 20180813)

• Add a “preserve-filename” option
• Preserve original filename when exporting in another directory

v1.0.1 (build 20180812)

• Minor correction, unused variable, filename correction

v1.0.0 (build 20180812)

• Initial version of the tool
• Support 1 or multiple file optimization.
• Avoid downloading picture if not optimized
• No recursive mode implemented yet
• Auto-exclude files which aren’t supported