https://github.com/arthur87/appiconset

Ruby script to write app icons required for macOS and iOS apps from 1024px x 1024px images.
https://github.com/arthur87/appiconset

android gems ios ruby

Last synced: 4 months ago
JSON representation

Ruby script to write app icons required for macOS and iOS apps from 1024px x 1024px images.

• Host: GitHub
• URL: https://github.com/arthur87/appiconset
• Owner: arthur87
• Created: 2017-11-30T13:15:04.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2025-04-26T04:00:15.000Z (about 1 year ago)
• Last Synced: 2025-10-17T15:00:53.447Z (9 months ago)
• Topics: android, gems, ios, ruby
• Language: Ruby
• Homepage: https://www.daispot.com
• Size: 930 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          


# Appiconset

[![Gem Version](https://badge.fury.io/rb/appiconset.svg)](https://badge.fury.io/rb/appiconset)

Ruby script to write app icons required for macOS and iOS apps from 1024px x 1024px images.

We have confirmed the operation in the following environments.

* macOS 15.1

Icon creation is supported for the following platforms.

* iOS/iPadOS

* macOS

* Universal

* watchOS

* Android

* tvOS

* icns.iconset

* icns(macOS only)

* favicon

# Guide

Create multiple app icons from one image.

```

$ appiconset g -i='sample.jpg' -o='output'   

```

## Square icons

Create an app icon from a 1024px x 1024px image.

A Contents.json and several png files will be created.  

Copy these files to AppIcon.appiconset in the Xcode project.

## tvOS icons

To create an icon for a tvOS app, prepare a 4640px x 1440px image.  

Generate the following image from the input image.  

The input image is the same as tv-top-shelf-wide, tv-top-shelf is the image from tv-top-shelf-wide with the red area removed, and tv is the image from tv-top-shelf with the green area removed.

| Directory name | Size | Image |

|--|--|--|

| tv-1024x1024 | 1024x1024 | ![tv-1024x1024](sample/tv-1024x1024/Icon@1x.png) |

| tv | 400x1440 | ![tv](sample/tv/Icon@2x.png) |

| tv-appstore | 1280x768 | ![tv-appstore](sample/tv-appstore/Icon@1x.png) |

| tv-top-shelf | 3840x1440 | ![tv-top-shelf](sample/tv-top-shelf/Icon@2x.png)|

| tv-top-shelf-wide | 4640x1440 |![tv-top-shelf-wide](sample/tv-top-shelf-wide/Icon@2x.png) |

## Icons of any size

Create 1x, 2/3x, and 1/3x icons from any size image.