IconPie

A simple command-line tool to generate application icons from raster graphics or vector graphics images.

Quickly combine multiple images and create professional-looking icons for most versions of Windows, macOS, iOS & Linux. Powered by IconBaker.

Features

• Simple interface.
• Sane defaults for the domain of icon composition.
• Supports outputting to stdout, allowing for piping.
• Available as a single executable.

Overview

An icon consists of a set of entries. An entry is simply an image that has a particular size. For example, this is an icon that has a 32x32 entry, a 64x64 entry and a 128x128 entry:

What does it do?

Notice that, in the example above, most entries are basically the same picture re-scaled to multiple sizes. IconPie simply automates the process of re-scaling the picture and combining those re-scaled entries into an icon.

How does it do it?

Re-scaling

When re-scaling pictures, IconPie preserves their original aspect-ratios. It also ensures that the all re-scaled images are square, by adding transparent borders if necessary. If the picture presents a transparent background, the transparency is preserved in the re-scaled images.

Interpolation

For raster graphics (jpeg, png, ...), IconPie uses nearest-neighbor interpolation by default, optimizing for small-resolution images.

Furthermore, when using nearest-neighbor interpolation, it only up-scales images on an integer scale, preserving as much detail as possible.

You can choose to opt-out of the default interpolation scheme for raster graphics by specifying a resampling filter with the -r flag, as described in the Usage section.

For vector graphics (svg), IconPie always uses linear interpolation regardless of any specified resampling filter. Vector graphics are also rasterized with antialiasing.

Usage

The formal docopt syntax for using IconPie is as follows:

• icon-pie icns ((-e | --entry) <file path> <size>... [(-r | --resample) (nearest | linear | cubic)])... [(-o | --output) <path>]
• icon-pie ico ((-e | --entry) <file path> <size>... [(-r | --resample) (nearest | linear | cubic)])... [(-o | --output) <path>]
• icon-pie favicon ((-e | --entry) <file path> <size>... [(-r | --resample) (nearest | linear | cubic)])... [--apple-touch] [--web-app] [(-o --output) <path>]
• icon-pie (-h | --help)
• icon-pie (-v | --version)

Options

• -e FILE (SIZE)..., --entry FILE (SIZE)... — Specify an entry's source image and target sizes.
• -r FILTER, --resample FILTER — Specify a re-sampling filter: nearest, linear or cubic. If no filter is specified the app defaults to nearest.
• -o PATH, --output PATH — Specify an output path. This is optional. If absent the output is directed to stdout.
• --apple-touch — Favicon specific option. Confire the output to include link tags for apple-touch icons in the HTML helper.
• --web-app — Favicon specific option. Confire the output to include a .webmanifest helper for PWA icons.
• -h, --help — Help.
• -v, --version — Display version information.

Examples

Let's say you have the following files saved at your file system.

We'll walk trought some practical examples of IconPie usage.

Simple Usage

Take big.svg, resize it to 32x32, 64x64 and 128x128. Then save it at icon.ico.

$ icon-pie ico -e big.svg 32 64 128 -o icon.ico

Sampling From Multiple Files

Take small.png, resize it to 32x32 and 64x64. Then take big.svg and resize it 128x128. Then combine the re-scaled entries in icon.icns.

$ icon-pie icns -e small.png 32 64 -e big.svg 128 -o icon.icns

Specifying a Resampling Filter

Take small.png, resize it to 32x32 and 64x64 using linear interpolation. Then take big.svg and resize it 128x128. Then combine the re-scaled entries into a favicon scheme.

$ icon-pie favicon -e small.png 64 128 -r linear -o ./favicon/

./favicon/helper.html

<link rel="icon" type="image/png" sizes="64x64" href="icons/favicon-0.png">
<link rel="icon" type="image/png" sizes="128x128" href="icons/favicon-1.png">

Support

Icon Formats

This are the icon formats IconPie can output to:

• ico
• icns
• favicon

Icns Support

Image Formats

This are the formats IconPie can use as input:

License

Licensed under MIT license(LICENSE-MIT or http://opensource.org/licenses/MIT).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.

Feel free to help out! Contributions are welcomed 😃