Appetizer is a macOS command line tool that takes an image (in PNG or JPG format) and makes suitable iOS and Android images and app icons.
Usage
Command Line
The command appetizer --help
will print information about the arguments.
Android Icon
appetizer icon.png 100 100 --androidIcon output
This will create 5 folders in an output
folder, each containing icon.png
images of different sizes:
The image in drawable-mdpi
will have the size 100x100. The others will have greater size.
You can set another name for the android folders, like mipmap
:
appetizer icon.png 100 100 --androidIcon output --androidFolderPrefix mipmap
iOS Icon
appetizer icon.png 100 100 --iosIcon output
This will create 3 images in the output
folder:
The size will be 100x100 for icon.png
, 200x200 for icon@2x.png
and 300x300 for icon@3x.png
.
iOS App Icon
appetizer icon.png 100 100 --iosAppIcon output
This will create many images in the output
folder:
The images have each size needed to fully specify an app icon on iOS for the iPhone and the iPad, including the 1024x1024 App Store icon.
(The provided size arguments 100 100
are ignored for app icons)
Single Icon
appetizer icon.png 100 100 --singleIcon output
This will create one image in the output
folder: icon.png
. The size will be 100x100.
Icon Name
By default, the generated icons will have the same name as the original icon.
The name can be changed using the --name
argument:
appetizer icon.png 100 100 --singleIcon output --name monkey
The generated icon will be monkey.png
.
Removing White Background
With a source image having white background and a black icon
, you might want wo remove the white backgound so that it becomes transparent.
appetizer icon.png 100 100 --singleIcon output --clearWhite
Adding the --clearWhite
parameter, the result will be an icon with transparent background:
Coloring
Using the --color
argument, all opaque regions of the icon will be colored:
appetizer icon.png 100 100 --singleIcon output --color #ff5500
Using the source image , the resulting image will look like this
Padding
You can add transparent padding to the generated icon using the --padding
argument:
appetizer icon.png 100 100 --singleIcon output --padding 20
Source and generated icon in comparison:
Or you can remove padding by providing a negative value:
appetizer icon.png 42 42 --singleIcon output --padding -2
This can be used to remove unwanted borders:
Installation
Binary release
Download an appetizer binary from the release section and copy it into the folder /usr/local/bin
so that it can be launched from anywhere in the command line.
Run sudo chmod 777 /usr/local/bin/appetizer
in the command line to make the file executable.
Compile the source
You can compile the source using the command line:
swift build -c release
Then copy the appetizer
binary from the folder .build/release
to /usr/local/bin
so that it can be launched from anywhere in the command line.
TODO
- Make a macOS app, which has the same functions but with a GUI instead of a command line tool. Users should then be able to use either the command line or the GUI tool.