/icns-creator

create .icns files for Mac OS

Primary LanguageSwiftMIT LicenseMIT

icns Creator

Download the app from Releases
(Requires Mac OS 11.0+)

DEMO & Instructions

The UI is bit different with the v1.3. 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.

Features

  • Simple and intuitive user interface
  • Support for PNG and JPG image formats
  • Automatic generation of icns files in variable sizes

Installation

To use icns Creator, follow these steps:

  1. Download the latest release from the Releases page. If you want to edit the source code, clone the repository to your local machine & open it with XCode.
  2. Open the icns Creator application file (icns-creator.app).
  3. If prompted, allow the application to run on your system.
  4. You're ready to start creating icns files out of PNG, JPG, or any other image document!

Usage

  1. Prepare your image file in your preferred image editor, ensuring it has a minimum size of 512x512 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 Select Image button and select the prepared image file.
  5. Click the Generate .icns button to start the conversion process.
  6. The icns files will be created in the same directory as the original image file.
  7. Use the generated icns file as an icon for your macOS applications.

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. Push your changes to your forked repository.
  5. Open a pull request in the main repository, explaining your changes and their benefits.

Please ensure that your contributions adhere to the Code of Conduct.

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.
  • Drag & drop folders or apps to edit their icns props on the fly for better UX
  • Distrubute through Homebrew
  • Set the icons using the app.