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 - 14.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 and JPG image 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

To use icns Creator, follow these steps:

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. Depending on your configuration, you need to disable “Gate keeper” option to install unsigned apps. You can have more information link
3. Unzip the file. DO NOT DOUBLE CLICK. Right-click on icns Creator application file (icns-creator.app) to run it.
4. If prompted, allow the application to run on your system.
5. You’re ready to start creating icns files out of PNG, JPG, or any other image document!

To build the app by yourself or make modifications on the source code (Optional)

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.

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).
• Set options for rounded corners: None, Rounded, Circular
• Add preview for changed options
• 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.
• Distrubute image conversion process into different CPU threads. It is a possible fix to avoid locking main thread during the icns creation process.
• Distrubute through Homebrew.
• Apple Codesign issues! (Optional: Will be exist forever)

This site is open source. Improve this page.