Badgy is a command line tool that creates variants of your icon by adding badge overlays.

Features

• ✅ 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

Disclaimer

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.

Dependency

This tool depends on

ImageMagick

brew

sh
brew install imagemagick

Installation

Homebrew (recommended)

brew tap arthurpalves/formulae
brew install badgy

Mint

mint install arthurpalves/badgy

Make

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

Usage: badgy  [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 badge

Small is a square badge containing only 1 character.

Usage: badgy small   [options]

Add small square label to app icon
Options:
  -c, --color          Specify badge color with a hexadecimal color code
  -h, --help                  Show help information
  -p, --position       Position on which to place the badge
  -r, --replace               Indicates Badgy should replace the input icon
  -t, --tint-color     Specify badge text/tint color with a hexadecimal color code
  -v, --verbose               Log tech details for nerds

Example

badgy small A ~/MyIcon.png --position topRight

Long badge

Long is a rectangular badge containing up to 4 characters.

Usage: badgy long   [options]

Add rectangular label to app icon
Options:
  -a, --angle          Rotation angle of the badge
  -c, --color          Specify badge color with a hexadecimal color code
  -h, --help                  Show help information
  -p, --position       Position on which to place the badge
  -r, --replace               Indicates Badgy should replace the input icon
  -t, --tint-color     Specify badge text/tint color with a hexadecimal color code
  -v, --verbose               Log tech details for nerds

Example

badgy long BETA ~/MyIcon.png --angle 15 --position bottom

Choose your colors

You can change the badge color and the tint/text color with

-c, --color

-t, -tint-color

Example

badgy long TEST ~/MyIcon.png --angle 15 --position bottom --color '#FFD700' --tint-color '#8B7500'

If a human readable color format is your dub, then check out a full list of supported named colors.

Replace your icon directly

The acceptable formats for your input icon are:

.png

.jpg

.appiconasset

--replace

Replace is a flag that you can use alongside your

.appiconasset

✅ Perfect for any icon set -> iOS, iPadOS, tvOS, macOS

badgy long TEST MyProjectSource/Assets.xcassets/AppIcon.appiconasset --angle 15 --position bottom --replace

License

Badgy is released under the MIT license. See LICENSE for more information.