icns-creator

icns Creator

A native Mac OS app that converts images to `.iconset` or `.icns` icon files.

・・・・・・・・・・ ༄ ・・・・・・・・・・

Download the app from Releases
(Requires minimum Mac OS 11.0 - 15.6.1).
⚠️ PLEASE FOLLOW "Installation" instructions ⚠️

DEMO & Instructions & QuickStart

The UI is a lot different with the v1. The following video is still appropriate. icns Creator is a macOS application that allows you to easily create icns files from any PNG or JPG image file. With this tool, you can quickly generate high-quality icns files to use as icons for your macOS applications or generate a single appropriate .iconset file. Codesigning is an headache for me! And I do not want to pay for an app that I release as open-source. You can review the code, if you have concerns about the app. Or simply, you can choose not to use the app 🖖🏻.

⁂

Features

• Simple and intuitive user interface.
• Support for GIF, PNG, JPG, JPEG, TIFF and even PSD image file formats.
• Automatic generation of icns files in variable sizes.
• iconset folder and individual .icns file generation.
• Options to set icon style for Apple design standarts (subtle shadow, corner radius, icon margin area).

⁂

Installation

Option 1. Disable The Gate Keeper (RECOMMENDED)

1. Download the latest release from the Releases page.

2. Move the unzipped icns Creator.app file to your Applications folder. DO NOT DOUBLE CLICK.

3. Disable the Gate Keeper: Open the Terminal app on your Mac and run the following command:

   sudo spctl --master-disable
   

Choose Anywhere option under System Settings->Privacy & Security->Security section.

1. Double-click the icns Creator.app file to run it.

2. You will be prompted with a warning that the app is from an unidentified developer. Click “Open”.

⁂

Option 2 (Without disabling the Gate Keeper)

1. Download the latest release from the Releases page.
2. Since the app is not signed by Apple, your OS does not open the app.You must enable

System Settings->Privacy & Security->Security->App Store and identified developers option.

1. Unzip the file. Double-click on icns Creator application file (icns-creator.app) to run it. It will not open because it is from an unidentified developer. Goto System Settings->Privacy & Security->Security and click Open Anyway button.
2. If prompted, allow the application to run on your system.
3. You’re ready to start creating icns files out of PNG, JPG, or any other image document!

⁂

Option 3 (For developers)

To build the app by yourself or make modifications on the source code (Optional). If you have issues because of Apple’s security issues, or you do not prefer to install compiled apps, you can compile the app by yourself and review the code as well.

1. Install XCode application from Appstore.
2. Download or clone the repository.

1. Unzip the folder and Double-click icns creator.xcodeproj file to open it in XCode.

1. Hit Run button to compile the project.

1. If everything goes well hopefully, you can find the app under the XCode’s Product menu.

⁂

Usage for Designers & Developers

1. Prepare your image file in your preferred image editor, ensuring it has a minimum size of 1024x1024 pixels.
2. Save the image file as a PNG or JPG file in a 1:1 aspect ratio for the best results.
3. Open the icns Creator application.
4. Click the Browse button or drag & drop the image.
5. .iconset tab creates a single icon file, or .icns tab creates individual .icns files required for html pages.
6. By default shadow, rounded corners and padding for the generated icon is enabled. For recent Mac OS standards, you should enable all of the options to apply Apple Design standarts. If you just want to generate .icns files as before, disable all of the options.
7. The files will be created in the same directory as the original image file.

⁂

Contribution

Contributions to icns Creator are welcome! If you would like to contribute to the project, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them with descriptive commit messages.
4. Do not delete commented codes please 😉
5. Push your changes to your forked repository.
6. Open a pull request in the main repository, explaining your changes and their benefits.

⁂

Star History

⁂

License

icns Creator is released under the MIT License. See the LICENSE file for more information.

⁂

Acknowledgements

• The icns Creator app was inspired by the need for a simple and efficient tool to create icns files for macOS applications.

⁂

Contact

If you have any questions, suggestions, or feedback, please feel free to use Issues section.

⁂

To do

• App release
• Make it compatible with min Mac OS 11.0
• Drag & drop design files onto the app window.
• Release major v2.
• Add feature to export icons with rounded-corners.
• Add feature to export icons with padding depending on Apple design standards.
• Add feature to export icons with shadow option.
• Set original icon
• Delete PNG file after creation of the individual .icns files
• Ask for destination to save files…
• Better UI to show switch toggle options
• Release major v3
• Improve documentation on compiling the project.
• Check the latest release on a Intel-based Mac (Rosetta Architecture may help to fix issues for Intel chip).
• Add preview for changed options
• Destination path dialog
• File name issue. When there is blank space in filename, the process fails. code solid.svg - failed. code-solid.svg - success.
• ‼️ Set options for rounded corners: None, Rounded, Circular, Tahoe OS
• ‼️ Lights around the app icon. Angle
• ‼️ Fill the background with a color or a pattern.
• ‼️ Set color for the background.
• ‼️ Set the size of the imported icon.
• ‼️ Set the position of the imported icon.
• ‼️ Display the icon grid similart to icon designer.
• ‼️ Update YouTube video tutotial.
• v4
  • Drag & drop folders or apps to edit their icns props on the fly for better UX.
  • Set the icons using the app.
  • Return to original icon option.
  • Keep the original icon in the original app directory.
• Optional: A workaround for testing, and permissions. Test the app on a fresh Mac.
• Optional: Distrubute image conversion process into different CPU threads. It is a possible fix to avoid locking main thread during the icns creation process.
• Optional: Distrubute through Homebrew or any other package manager.
• Optional: Apple Codesign issues! (Will exist forever because of Apple’s buggy developer registration process)

This site is open source. Improve this page.