Skip to content

Latest commit

 

History

History
74 lines (51 loc) · 2.64 KB

README.md

File metadata and controls

74 lines (51 loc) · 2.64 KB

PNG to ICNS

cover_png_to_icns

A Bash / Shell script to convert your PNG images into Mac OS specific type ICNS (iconset) !

Image Requirements

  • Format should be PNG (transparency isn't mandatory).
  • Dimensions need to be 1024x1024 pixels.

Image Recommendations

  • A transparent background will be removed (as with the cat icon above)
  • Icons with a background generally do no fill the entire 1024x1024 space. They are usually inset by about 50px on each side. The rounded-rect-inset.png file in this repo provides a template that matches the style of many other icons: it's a white rounded-rectangle with a transparent border. Center your icon within the template, then use the procedure below.

How to Use

  1. Let’s get started by downloading the project, and move into the newly created folder:

    > git clone https://github.com/BenSouchet/png-to-icns.git
    Cloning into 'png-to-icns'...
    
    > cd png-to-icns

    Or copy/paste the script file png_to_icns.sh in a directory

  2. Optionally: Place the 1024x1024 pixels image (.png) you want to convert in the folder

  3. Start the script and give the path to the image with -i image_path

    > ./png_to_icns.sh -i <path_to_my_image.png>
    INFO: The icon has been successfully created: ./icon.icns
  4. Done! The new icon has been created, the path of this .icns is indicate on the info message in your terminal.

Errors / Bugs

If an error occurs, a message with the error(s) info will appear in the terminal. If you cannot see or understand the error, open an issue.

Others Resources & Useful links

Contibutors

Rich Brown

Author & Maintainer

PNG to ICNS has been created and is currently maintained by Ben Souchet.

The code present in this repository is under MIT license.