Ikona (Εικόνα)

CLI tool for image processing

Install & Run

sudo npm install -g ikona

Then from your command line just type ikona

Now you can use the following commands:

Commands

help [command]

Displays helpful information for a command. e.g. help resize

Example

help resize

exit

Exits from the cli

resize <imageDir>

Resizes an image.

Example

resize realcat.jpg -h 200 -w 200 -o resizecat

Options

Option	Description
-h	The height of the new image	Optional, default="auto"
-w	The width of the new image	Optional, default="auto"
-o	The name of the new file	Optional, default="chroma.jpg"
-m	The algorithm that will be used for resizing	[Bilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier], default=Bilinear

scale <imageDir>

Scale an image by the given factor

Example

scale realcat.jpg -f 1.5 -o bigcat

Options

Option	Description
-f	Scale factor	Optional, default=2
-o	The name of the new file	Optional, default="chroma.jpg"
-m	The algorithm that will be used	[Bilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier], default=Bilinear

scaletofit <imageDir>

Scale the image to the largest size that fits inside the given width and height

Example

scaletofit realcat.jpg -h 450 -w 500 -o scaletofitcat

Options

Option	Description
-h	The height of the new image	Optional, default="auto"
-w	The width of the new image	Optional, default="auto"
-o	The name of the new file	Optional, default="chroma.jpg"
-m	The algorithm that will be used	[Bilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier], default=Bilinear

cover <imageDir>

Scale the image to the given width and height, some parts of the image may be clipped

Example

cover realcat.jpg -h 300 -w 100 -o covercat

Options

Option	Description
-h	The height of the new image	Optional, default="auto"
-w	The width of the new image	Optional, default="auto"
-o	The name of the new file	Optional, default="chroma.jpg"
-m	The algorithm that will be used	[Bilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier], default=Bilinear

contain <imageDir>

Scale the image to the given width and height, some parts of the image may be letter boxed

Example

contain realcat.jpg -h 200 -w 250 -o containcat

Options

Option	Description
-h	The height of the new image	Optional, default="auto"
-w	The width of the new image	Optional, default="auto"
-o	The name of the new file	Optional, default="chroma.jpg"

swap <imageDir> <channel1> <channel2>

Swap the color channels of an image

Example

swap realcat.jpg green blue

Options

Option	Description
-h	The height of the new image	Optional, default="auto"
-w	The width of the new image	Optional, default="auto"
-o	The name of the new file	Optional, default="chroma.jpg"
-m	The algorithm that will be used for resizing	[Bilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier], default=Bilinear

crop <imageDir>

Crop an image on the given points

Example

crop realcat.jpeg -x 20 -y 20 -h 70 -w 70 -o croppedcat

Options

Option	Description
-x	Starting point in the x axis	Optional, default=0
-y	Starting point in the y axis	Optional, default=0
-h	The height of the new image	Optional, default=250
-w	The width of the new image	Optional, default=250
-o	The name of the new file	Optional, default="chroma.jpg"

brightness <imageDir>

Adjust the brighness by a value -1 to +1

Example

brightness realcat.jpg -f 0.5 -o brightcat

Options

Option	Description
-f	Brightness factor	Optional, default=1
-o	The name of the new file	Optional, default="chroma.jpg"

contrast <imageDir>

Adjust the contrast by a value -1 to +1

Example

contrast realcat.jpg -f 0.5 -o contrastcat

Options

Option	Description
-f	Contrast factor	Optional, default=1
-o	The name of the new file	Optional, default="chroma.jpg"

grey <imageDir>

Remove colour from the image

Example

grey realcat.jpg -o greycat

Options

Option	Description
-o	The name of the new file	Optional, default="chroma.jpg"

normalize <imageDir>

Normalize the channels in an image

Example

normalize realcat.jpg -o normalcat

Options

Option	Description
-o	The name of the new file	Optional, default="chroma.jpg"

invert <imageDir>

Normalize the channels in an image

Example

invert realcat.jpg -o invertcat

Options

Option	Description
-o	The name of the new file	Optional, default="chroma.jpg"

dominant <imageDir>

Displays the dominant colors of an image

Example

dominant abstract.jpg -h

Options

Option	Description
-h	Displays the colors in hex format
-w	Displays the colors in rgba format

fade <imageDir>

Multiply the alpha channel by each pixel by the factor f, 0 - 1

Example

fade realcat.jpg -f 0.5 -o fadecat

Options

Option	Description
-f	Fade factor	Optional, default=1
-o	The name of the new file	Optional, default="chroma.jpg"

sepia <imageDir>

Apply a sepia wash to the image

Example

sepia realcat.jpg -o sepiacat

Options

Option	Description
-o	The name of the new file	Optional, default="chroma.jpg"

posterize <imageDir>

Apply a posterization effect with f factor

Example

posterize realcat.jpg -f 5 -o postercat

Options

Option	Description
-f	Posterize factor	Optional, default=1
-o	The name of the new file	Optional, default="chroma.jpg"

rotate <imageDir>

Rotate the image clockwise by a number of degrees.

Example

rotate realcat.jpg -d 30 -o rotatedcat

Options

Option	Description
-d	Degrees	Optional, default=90
-o	The name of the new file	Optional, default="chroma.jpg"

flip <imageDir>

Rotate the image clockwise by a number of degrees.

Example

flip realcat.jpg -h -o flippedcat

Options

Option	Description
-h	Horizontally
-v	Vertically
-o	The name of the new file	Optional, default="chroma.jpg"