Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 2.41 KB

README.md

File metadata and controls

53 lines (33 loc) · 2.41 KB

Icic

Gem Version

icic is a tool to simplify the generation of iOS and Android ICON image asset from an image file. For Android, this tool will generate & classify icon image based on the dpi. For iOS this tool will create 1x, 2x, 3x and also Contents.json metadata file inside filename.imageset folder.

Why

So many helper tools out there to automate the generation of icon image asset, but most of them are desktop base which need many interaction until the final asset is created and also the app is not free. The other tool is webapp like Android Asset Studio and like the desktop app, still need many interaction until the final asset is created and the final asset will be in zip format that user need to unzip it first before using. What I want is minimum interaction for image asset generation, that's why this CLI app was born.

Requirements

This tool rely on ImageMagick or GraphicsMagick so make sure this tools already installed. You can check if you have it installed by running

$ convert -version
Version: ImageMagick 7.0.7-7 Q16 x86_64 2017-10-08 http://www.imagemagick.org
Copyright: © 1999-2017 ImageMagick Studio LLC
License: http://www.imagemagick.org/script/license.php
Features: Cipher DPC HDRI Modules
Delegates (built-in): bzlib freetype jng jpeg ltdl lzma png tiff xml zlib

Installation

Install this tool using rubygem

gem install icic

Usage

Run on terminal

icic

Then it will prompt for

  • The original image file (that will be converted)
  • The platform (iOS or Android)
  • The name of generated file
  • The output folder

example usage

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/hidrodixtion/icic. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Icic project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.