AppIcon generates *.appiconset contains each resolution image for iOS, MacOS.

AppIcon.appiconset
├── Contents.json
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
└── [email protected]

$ brew install Nonchalant/appicon/appicon

$ mint run nonchalant/appicon

Clone the master branch of the repository, then run make install.

$ git clone https://github.com/Nonchalant/AppIcon.git
$ make install

AppIcon needs path of base image(.png). The size of base image is 1024x1024 pixel preferably.

$ appicon iTunesIcon-1024x1024.png

You can see options by appicon --help.

Default: AppIcon

Default: ./AppIcon.appiconset

Default: false

Default: false

$ make debug

$ make build

$ make test

Takeshi Ihara [email protected]

This GitHub Action generates app icons for iOS and macOS applications using the AppIcon tool. It can be triggered manually or via a webhook to automatically generate app icons based on a provided image URL.

You can use this action in your workflow by adding the following step:

- name: Generate App Icons
  uses: ka1ne/AppIcon@v1  # Replace with the latest version
  with:
    icon-source: 'https://example.com/path/to/icon.png'
    output-path: './Assets.xcassets/AppIcon.appiconset'
    icon-name: 'MyAppIcon'
    mac: 'true'
    watch: 'false'

• icon-source (required): Path or URL of the base icon image (1024x1024 PNG)
• output-path (optional): Path where the generated AppIcon.appiconset will be saved (default: './AppIcon.appiconset')
• icon-name (optional): Name for the generated icons (default: 'AppIcon')
• mac (optional): Generate macOS icons (default: 'false')
• watch (optional): Generate watchOS icons (default: 'false')

To trigger this action programmatically via GitHub's API, follow these steps:

1. Create a GitHub Personal Access Token (PAT) with repo scope.

2. Send a POST request to GitHub's Repository Dispatch API:

curl -X POST \
  -H "Authorization: Bearer YOUR_GITHUB_PAT" \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/repos/{owner}/{repo}/dispatches \
  -d '{
    "event_type": "generate-app-icon",
    "client_payload": {
      "icon_source": "https://example.com/path/to/icon.png"
    }
  }'

The client_payload should contain:

• icon_source (required): Path or URL to your 1024x1024 PNG icon

{
  "event_type": "generate-app-icon",
  "client_payload": {
    "icon_source": "https://example.com/path/to/icon.png"
  }
}

Note: The other parameters (output_path, icon_name, mac, watch) are configured in the workflow file and cannot be modified via the API payload.

Appicon is available under the MIT license. See the LICENSE file for more info.