(for AWS docs click here)
JPEGmini is a patented photo optimization technology, which significantly reduces the size of photographs without affecting their perceptual quality. The technology works in the domain of baseline JPEG, resulting in files that are fully compatible with any browser, photo software or device that support the standard JPEG format.
JPEGmini is capable of reducing the size of standard JPEG photos by up to 80% (5X), while preserving their perceptual visual quality. The JPEGmini algorithm imitates the perceptual qualities of the human visual system, ensuring that each photo is compressed to the maximum extent possible by removing redundancies, without creating any visual artifacts in the process. This enables fully automatic, maximal compression of millions of photos with no human intervention required.
Prerequisites
The JPEGmini Server software requires a Linux operating system. Since we are using a cloud-based licensing, the computer on which JPEGmini is running should be connected to the Internet. The current user should have elevated permissions (root or sudo) for the installation.
Installing the JPEGmini Server Software
If you are using Red Hat Linux, execute the following command:
If you are using Debian Linux, execute the following command:
Uninstalling the JPEGmini Server Software
If you are using Red Hat Linux, execute the following command:
If you are using Debian Linux, execute the following command:
License Configuration
In order to run JPEGmini Server for the first time, you will need to enter your license key. This license key is provided together with your software. If you didn’t receive the license key, please contact JPEGmini support.In order to do so run the following command :
Please note:
* The current user should have elevated permissions (root or sudo) for the first activation.
* After JPEGmini is activated with the license key for the first time sudo is not required (and not recommended) in order to use it.
* JPEGmini will automatically get the updated license from the JPEGmini servers once every 24 hours, in case of a failure to do so it will retry once every hour.
General
The JPEGmini Server application takes a JPEG file as input, and outputs a smaller JPEG file with the extension “_mini.jpg”. The application can also be used on a folder of photos. When processing is finished, the application reports the sizes of the original and re-compressed photos, and the reduction factor achieved.
Note: If you are using the low-latency version of JPEGmini, which is called JPEGminiRT, substitute jpegmini_rt instead of jpegmini in all of the examples below.
Supported Formats
The JPEGmini Server supports input files in standard JPEG format. Supported resolutions are from 32x32 pixels up to 60 Megapixels.
Typical Usage
Typical usage only requires specifying the input file name:
The output in this case will be the file `test_mini.jpg`.
The application can also be executed on a complete folder, for example:
In this case, all files in the folder `User/TestImages` will be processed by jpegmini.
The jpegmini application supports the following command line options:
When executing JPEGmini on a folder (using the -f=<folder path> command line option), the above information is displayed for each processed file. After completing the processing of all files in the folder, the application prints out the following summary information:
Total number of processed files
Total size of input files
Total size of output files
Recompression ratio: The ratio between the total size of the input files and the total size of the output files, and the difference between them in percent.
Below is an example of a typical folder summary report displayed by JPEGmini.
Note that this summary information refers to all the files which were processed by JPEGmini during the current execution, including files in subfolders (if the –r=1 option was used).
Our licensing solution requires that the computer on which JPEGmini is running should be connected to the Internet. By default, the license cache file is used, and the license is read from the local cache. But when the license is retrieved for the first time, or when the cache is refreshed, a delay of a few seconds can be expected as the software validates its license with our cloud-based licensing server.
The recompression ratios achieved depend on the image resolution, quality and content, and therefore are different for each image. However, the perceptual quality of the resulting image will always be the same as the original, when
-qual=0(Best quality) is used.JPEGmini generates the highest recompression ratios for first-generation JPEG images that are created by digital cameras (stand-alone devices or embedded in cellphones). Using JPEGmini on images that have been edited, re-sized or processed by image editing software may cause lower recompression ratios.
If JPEGmini skips input images without processing them (for example if their resolution is not supported, or if they are highly compressed and the
–shcflag is turned on), the input images are copied to the output with the extension “_copy.jpg”.
JPEGmini only supports JPEG images as input. Non-JPEG images can be converted to JPEG and then optimized by JPEGmini. In this case, it is recommended to convert the images to JPEG at a JPEG quality (QF) of 100.
The recompression ratios achieved depend on the image resolution, quality and content, and therefore are different for each image. However, the perceptual quality of the resulting image will always be the same as the original, when -qual=0 (Best quality) is used.
JPEGmini generates the highest recompression ratios for first-generation JPEG images that are created by digital cameras (stand-alone devices or embedded in cellphones). Using JPEGmini on images that have been edited, re-sized or processed by image editing software may cause lower recompression ratios.
If JPEGmini skips input images without processing them (for example if their resolution is not supported, or if they are highly compressed and the –shc flag is turned on), the input images are copied to the output with the extension “_copy.jpg”.
JPEGmini only supports JPEG images as input. Non-JPEG images can be converted to JPEG and then optimized by JPEGmini. In this case, it is recommended to convert the images to JPEG at a JPEG quality (QF) of 100.
EXIT CODES
Below is a list of exit codes for the JPEGmini Server.
AUTHOR
The JPEGmini Server is developed by Beamr Imaging Ltd.