@keyvanfatehi/icon-gen

1.0.8 • Public • Published

npm-icon-gen

node v6, v7 npm version Build Status Document

Generate an icon files from the SVG or PNG files.

Support formats

Supported the output format of the icon are following.

Platform Icon
Windows app.ico or specified name.
OS X app.icns or specified name.
Favicon favicon.ico and favicon-XX.png.

Installation

$ npm install icon-gen

Usage

SVG

SVG files are rendering to PNG file in svg2png. Rendering files is output to a temporary directory of the each OS.

Rendering of svg2png is run by phantomjs. Please use the PNG directory If the rendering quality there is a problem.

const icongen = require( 'icon-gen' );

const options = {
  report: true,
  names: {
    ico: 'foo',
    icns: 'bar'
  }
};

icongen( './sample.svg', './dist', options )
.then( ( results ) => {
  console.log( results );
} )
.catch( ( err ) => {
  console.error( err );
} );

PNG

Generate an icon files from the directory of PNG files.

const icongen = require( 'icon-gen' );

const options = {
  type: 'png',
  report: true
};

icongen( './images', './dist', options )
.then( ( results ) => {
  console.log( results );
} )
.catch( ( err ) => {
  console.error( err );
} );

Required PNG files is below. Favicon outputs both the ICO and PNG files ( see: audreyr/favicon-cheat-sheet ).

Name Size ICO ICNS Fav ICO Fav PNG
16.png 16x16
24.png 24x24
32.png 32x32
48.png 48x48
57.png 57x57
64.png 64x64
72.png 72x72
96.png 96x96
120.png 120x120
128.png 128x128
144.png 144x144
152.png 152x152
195.png 195x195
228.png 228x228
256.png 256x256
512.png 512x512
1024.png 1024x1024

Node API

icongen

icongen is promisify function.

icongen( src, dest, [options] )
Name Type Description
src String Path of the SVG file or PNG files directory that becomes the source.
dest String Destination directory path.
options Object Options.

options:

Name Type Description
type String Type of input file. Allowed value is a svg or png. 'svg' is SVG file, png is PNG files directory. Default is svg.
modes Array Mode of output files. Allow value is a ico, icns, favicon and all. Default is all.
names Object Change an output file names for ICO and ICNS.
report Boolean Display the process reports. Default is false, disable a report.

names:

Use this property is specified without an extension. Default name is the app.

Name Type Description
ico String Name of the ico file.
icns String Name of the icns file.

CLI

Usage: icon-gen [OPTIONS]

  Generate an icon from the SVG or PNG file.

  Options:
    -h, --help    Display this text.

    -v, --version Display the version number.

    -i, --input   Path of the SVG file or PNG file directory.

    -o, --output  Path of the output directory.

    -t, --type    Type of the input file.
                  'svg' is the SVG file, 'png' is the PNG files directory.
                  Allowed values: svg, png
                  Default is 'svg'.

    -m, --modes   Mode of the output files.
                  Allowed values: ico, icns, favicon, all
                  Default is 'all'.

    -n, --names   Change an output file names for ICO and ICNS.
                  ex: 'ico=foo,icns=bar'
                  Default is 'app.ico' and 'app.ico'.

    -r, --report  Display the process reports.
                  Default is disable.

  Examples:
    $ icon-gen -i sample.svg -o ./dist -r
    $ icon-gen -i ./images -o ./dist -t png -r
    $ icon-gen -i sample.svg -o ./dist -m ico,favicon -r
    $ icon-gen -i sample.svg -o ./dist -n ico=foo,icns=bar

  See also:
    https://github.com/akabekobeko/npm-icon-gen

ChangeLog

License

Readme

Keywords

Package Sidebar

Install

npm i @keyvanfatehi/icon-gen

Weekly Downloads

0

Version

1.0.8

License

MIT

Last publish

Collaborators

  • keyvanfatehi