Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leopic/makeappicon

Generate an iconset for your iOS App with ease.
https://github.com/leopic/makeappicon

Last synced: 3 months ago
JSON representation

Generate an iconset for your iOS App with ease.

Host: GitHub
URL: https://github.com/leopic/makeappicon
Owner: leopic
License: mit
Created: 2015-01-15T19:59:43.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2024-09-12T06:20:15.000Z (4 months ago)
Last Synced: 2024-10-13T14:42:58.045Z (3 months ago)
Language: JavaScript
Homepage:
Size: 8.79 MB
Stars: 35
Watchers: 3
Forks: 7
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: license

Awesome Lists containing this project

README

# makeappicon

[![Build Status](https://travis-ci.com/leopic/makeAppIcon.svg?branch=master)](https://travis-ci.com/leopic/makeAppIcon)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=leopic_makeAppIcon&metric=alert_status)](https://sonarcloud.io/dashboard?id=leopic_makeAppIcon)

Open source alternative to [makeappicon.com](http://makeappicon.com/) to generate all icons for your iOS Apps. This module generates all ios icons with a single command and produces a drag and drop ready `AppIcon.appiconset`!

## Requirements

- [Homebrew](https://brew.sh/) to install packages on MacOS
- `gm/covert` binaries in your `$PATH` as [explained here](http://stackoverflow.com/questions/17756587/installing-graphicsmagick-on-mac-os-x-10-8). On MacOS, run the following:

```bash
brew uninstall imagemagick graphicsmagick libpng jpeg
brew cleanup -s
brew install graphicsmagick
```

## Usage:

Fire up a terminal and type:

```bash
npm install -g makeappicon
```

Create a 1024x1024 png image and execute the script as such:

```bash
makeappicon --base-icon pathToBaseIcon.png
```

That takes the icon file and generates all the images that you need into the `AppIcon.appiconset`
directory. Open XCode, open your `Images.xcassets` pane and delete the default AppIcon entry, now drag and
drop the entire `AppIcon.appiconset` directory into that pane and you should be good to go! Build your app
and you should see your new icon all over the place.

## Troubleshooting

### gm/convert binaries can't be found

If you get a message saying "this most likely means the gm/convert binaries can't be found", refer to Requirements.

## Credits:

- [makeappicon.com](http://makeappicon.com) for the idea
- Toaster ASCII Art from [retrokunkie](http://www.retrojunkie.com/asciiart/food/toasters.htm)

## Disclaimer

This module is in no way, shape or form associated with OURSKY.

## License