Project

appiconset

0.0
The project is in a healthy, maintained state
This is a Ruby script that will write out app icons needed for macOS apps, iOS apps, etc. from a 1024px x 1024px image.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

Runtime

 Project Readme

Appiconset

Gem Version

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 400x1440 tv
tv-top-shelf 3840x1440 tv-top-shelf
tv-top-shelf-wide 4640x1440 tv-top-shelf-wide

Icons of any size

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