Generate pretty, beveled OSX folder icons.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 81 commits behind lgarron:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Apple Folder Cube Folder Octocat Folder Rhombic Hexecontrahedron Folder Octocat Folder

Try it!

git clone git://
cd folderify
for file in examples/src/*.png; do ./folderify $file; done
open examples/src/

You should see a bunch of new .icns files that were automatically generated from the .png masks.

Or try this:

git clone git://
cd folderify
./folderify examples/src/folder_outline.png .

The repository folder should now have an icon.



folderify <image.png> [<optional_target_file.png>]
  • The input file should be an image with a transparent background. For best results:
    • Use a .png file
    • Use a black figure on a transparent background. (Colored images also work, but may produce a weaker effect.)
    • Make sure the corner pixels of the image are transparent. They are currently used for empty margins.
  • folderify will produce a .icns file containing 5 resolutions of folder icons. The .icns file will also have itself as its icon.
    • (Note that normal .icns files do NOT have themselves as an icon.)
  • The icon can be copied from the generated .icns to any other file folder using the "Get Info" pane in the Finder.
    • (Note that this does NOT normally work for .icns files, but it does work for such files that have been generated using folderify.)


  • ImageMagick - for image processing (you should be able to run convert on the commandline).
  • Python 2 - to help assign the icon file to itself.
  • Apple Developer Tools (for /Developer/Tools/Rez)


  • Tweak the settings to approximate the default OSX icons as closely as possible (fix folder shade, mask shade, and bevel settings).
  • Allow intermediate files to be generated and combined easily (e.g. to use a different source mask for the smaller icons).
  • Use -clone instead of writing to file.
  • Maybe: Handle automatic positive/negative detection, so that the mask doesn't have to be generated by hand.
  • Allow more procedural image generation (e.g. accept a string as input).
  • List of credits and thanks.