<img src="https://github.com/SAP/macOS-icon-generator/blob/main/readme_images/icons_banner_github.png" width="879"><br/>

<br/>

# Icons

[![REUSE status](https://api.reuse.software/badge/github.com/SAP/macOS-icon-generator)](https://api.reuse.software/info/github.com/SAP/macOS-icon-generator)

**The easiest way to create customized icons for your app!**

_Icons_ is an application for macOS which enables you to create standardized app icons in PNG format. No graphic skills are needed! Just drag and drop your desired image into the application to create a full icon set, including installer and uninstaller icon, as well as an animated version of the uninstaller icon!

For Mac administrators: When working in multiple environments, e.g. development, test and production environments, the _Icons_ app helps you to keep track of your app versions, by giving the option to add banners to the icons. The _Icons_ can be used for any management tools like Jamf Pro or the open source Munki software installation tool.

<br/>

# Features

🌟 Finder extension

🌈 Highly customizable banner

🖱️ Easy drag & drop function

✅ Install and animated uninstall icon

🗑️ Custom delete badge for uninstall icon

❌ No graphic skills needed

⌨️ Command line for automation

💻 For macOS 13 and newer

<br/>

# Demo

Have a look at how quick and easy an icon set can be created by drag and drop:

https://github.com/user-attachments/assets/b4886507-3a57-43f1-8916-38254b44adea

<br/>

# Documentation

To learn more about _Icons_ features, make sure to take a look at our [wiki](https://github.com/SAP/macOS-icon-generator/wiki) or the links below:

* [Installation](https://github.com/SAP/macOS-icon-generator/wiki/Installation)
* [Uninstallation](https://github.com/SAP/macOS-icon-generator/wiki/Uninstallation)
* [Using _Icons_](https://github.com/SAP/macOS-icon-generator/wiki/Using-Icons)
* [FAQ](https://github.com/SAP/macOS-icon-generator/wiki/Frequently-Asked-Questions)

<br/>

# Example

This is an example how the icon set could look like. The first image shows the `install.png`, the second image shows the `uninstall.png` and the third is the `uninstall_animated.png`. All images are saved in PNG format.

<img src="https://github.com/SAP/macOS-icon-generator/blob/main/readme_images/install.png" width="256"><img src="https://github.com/SAP/macOS-icon-generator/blob/main/readme_images/uninstall.png" width="256"><img src="https://github.com/SAP/macOS-icon-generator/blob/main/readme_images/uninstall_animated.png" width="256">

<br/>

# License

Copyright (c) 2022-2026 SAP SE or an SAP affiliate company and Icons contributors. Please see our [LICENSE](https://github.com/SAP/macOS-icon-generator/blob/main/LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the [REUSE](https://api.reuse.software/info/github.com/SAP/macOS-icon-generator) tool.

<br/>

# Security
Found a security-related issue or vulnerability and want to notify us? [Please see here for how to report it](https://github.com/SAP/macOS-icon-generator/security/policy).

<br/>

# Support

This project is 'as-is' with no support, no changes being made. You are welcome to make changes to improve it but we are not available for questions or support of any kind.
