Badgy is a command line tool that creates variants of your icon by adding badge overlays.
- ✅ Small (square) and long (rectangular) labels
- ✅ Position it on
top, left, bottom, right, topLeft, topRight, bottomLeft, bottomRight, center
- ✅ Supports rotation (long badge only)
- ✅ Converts your icon to different sizes already
- ✅ 🚀 Ability to automatically replace your
.appiconasset, mainting the same name and sizes
This tool is NOT meant to create production ready icons. As I see myself constantly using at least 4 variants of the same application for B2B customers (think of 1 environment for DEV, QA, UAT, PROD and more), I quickly created this tool to differentiate the application icon for those variants.
There are many things that might not work as you expect, and there are many others that you wish this could do. Feel free to contribute to the project and make it better.
This tool depends on
ImageMagick. If not installed with
brew make sure to install this dependency yourself:
brew install imagemagick
brew tap arthurpalves/formulae brew install badgy
mint install arthurpalves/badgy
git clone https://github.com/arthurpalves/badgy.git cd badgy make install
Swift Package Manager
Use as CLI
git clone https://github.com/arthurpalves/badgy.git cd badgy swift run badgy
Usage: badgy <command> [options] A command-line tool to add labels to your app icon Commands: small Add small square label to app icon long Add rectangular label to app icon help Prints help information version Prints the current version of this app
Small is a square badge containing only 1 character.
Usage: badgy small <char> <icon> [options] Add small square label to app icon Options: -h, --help Show help information -p, --position <value> Position on which to place the badge -r, --replace Indicates Badgy should replace the input icon Only works if input is of format .appiconasset -v, --verbose Log tech details for nerds
badgy small A ~/MyIcon.png --position topRight
Long is a rectangular badge containing up to 4 characters.
Usage: badgy long <labelText> <icon> [options] Add rectangular label to app icon Options: -a, --angle <value> Rotation angle of the badge -h, --help Show help information -p, --position <value> Position on which to place the badge -r, --replace Indicates Badgy should replace the input icon Only works if input is of format .appiconasset -v, --verbose Log tech details for nerds
badgy long BETA ~/MyIcon.png --angle 15 --position bottom
Replace your icon directly
The acceptable formats for your input icon are:
If the later is used, Badgy will find the largest image available in the asset to serve as input.
Replace is a flag that you can use alongside your
.appiconasset input, it will iterate over all images available in the asset and convert the largest icon to the respective size, this allows Badgy to maintain the same amount of files, same names and same sizes.
✅ Perfect for any icon set -> iOS, iPadOS, tvOS, macOS
badgy long TEST MyProjectSource/Assets.xcassets/AppIcon.appiconasset --angle 15 --position bottom --replace