Skip to content
Put the icon from a macOS app on a colour-matched background ready for publication
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Writing about apps? IconBackground allow you to create hero images from the icon in two seconds. IconBackground extracts the icon from a macOS app, or takes any icon from the Finder, and puts it on a beautiful colour-matched background.


IconBackground can take a macOS app:

And make this image:

It can also take any icon, in this case an iOS app icon:

And make this image:

The colour of the background is the dominant colour of the central part of the original icon. IconBackground might produce different results on different occasions, as the position of the central part is slightly shifted from launch to launch.

To preserve the aspect ratio of the hero image, the size of the output is tied to the size of the original icon. When using really small icons, the output will be limited to 500 × 312px. The output will be 1,000 × 625px when using 512px icons, and 2,000 × 1,250px when using 1,024px icons. Bigger icons are not (yet) supported.


To extract the icon from a macOS app:

python3 -a <path_of_the_app>

To use any icon stored on disk:

python3 -i <path_of_the_icon>

For best results, use icons that sit on a transparent background (.ICNS or .PNG files).


  • argparse
  • biplist
  • collections
  • pillow
  • random
  • sklearn


EUPL 1.2.

You can’t perform that action at this time.