imgconv

About

Imgconv is a CLI tool for basic image manipulation. It can be used to convert jpeg, gif, png, tiff, and webp files to jpeg, gif, png, or tiff files. It can also be used to rescale images. Imgconv is powered mainly by Go's standard image library. Encoding webp files is currently disabled by default; see the "Enabling webp encoding" section below for information on how to enable it.

How to use

To begin, install this package using the Go compiler:

go install github.com/cdillond/imgconv@latest

When running imgconv, the following parameters are mandatory:

-mode string [REQUIRED] local, remote, or dir
-to string [REQUIRED] the file format of the output image; gif, jpeg, png, and tiff are supported
-url string [REQUIRED] the url of the source image or, if -mode=dir, the path of the target directory

A complete list of accepted parameters can be found in the Flags section.

The -mode flag accepts three possible values: local, remote, and dir.

• local: imgconv parses the local file specified by the -url flag.
• remote: imgconv downloads the resource specified by the -url flag. Only https, http, and (base64-encoded) data schemes are allowed.
• dir: imgconv parses all files in the local directory specified by the -url flag. By default, all subdirectories and their contents are ignored.

Flags

The following flags are accepted:

Special cases

Certain flags cannot be used in all cases. Be aware of the following restrictions:

• -out cannot be used in dir mode.
• If -out is an absolute path, it overrides -dstDir.
• -maxProcs should only be used in dir mode.
• -recursive should only be used in dir mode.
• Only one of -maxSidePixels and -minSidePixels should be specified at a time. If values for both flags are provided, only -maxSidePixels will be used.
• Only one of -scaleToHeight and -scaleToWidth should be specified at a time. If values for both flags are provided, only -scaleToHeight will be used.
• At most one of -maxSidePixels, -minSidePixels, -scaleToHeight, and -scaleToWidth should be specified at a time. If multiple values are provided anyway, -scaleToHeight and -scaleToWidth override -maxSidePixels and -minSidePixels.
• If at least one of -height and -width is specified, any values provided for -maxSidePixels, -minSidePixels, -scaleToHeight, or -scaleToWidth are ignored.
• -webpLossy and -webpQual are only available if webp encoding is explicitly enabled at build time.

Naming procedure

By default, files will be saved under the same name as the source file, with the appropriate file extension. This behavior can be modified using the -out flag. Important exceptions include:

1. File names that contain periods may be truncated, and may not be parsed correctly.
2. If an output file name cannot be parsed, a name will be assigned at random.
3. If an output file name conflicts with an existing file, "_v" and a version number will be appended to the end of the new file name, unless the file name is specified by the -out flag, in which case the new file will replace the existing one.
4. If the remote URL specified by -url is a base64-encoded data URL and no output file name is specified by -out, a random name will be generated for the output file.

Enabling webp encoding

Imgconv provides experimental support for webp encoding via bindings to Google's libwebp C library. To use this feature, libwebp must be installed in a standard location and cgo must be enabled (a C compiler is required for this to work). When building imgconv, include webpenc as a build tag. On Debian-based Linux systems, for example, this can be achieved using the following commands:

sudo apt install libwebp-dev
go env -w CGO_ENABLED=1
go install -tags webpenc github.com/cdillond/imgconv@latest

This solution is suboptimal, and setting it up might be more hassle than it is worth. It has only been tested on Linux and Windows.