folderify

Generate pixel-perfect macOS folder icons in the native style.

• Works for OS X 10.5 (Leopard) through macOS 13 (Ventura).
• Automatically includes all icon sizes from 16x16 through 512x512@2x.
• Light or dark mode (automatically selected by default).

Using folderify? Let me know or let me know and I'd love to feature some real-world uses!

Install using Homebrew

shell brew install folderify

Usage

Use a mask to assign an icon to a folder:

shell folderify mask.png /path/to/folder

Generate mask.icns and mask.iconset files:

shell folderify mask.png

Generate icon files for a specific version of macOS (the default is your current version):

shell folderify --macOS 11.0 mask.png

By default, folderify uses your system's current light/dark mode. Use --color-scheme to override this:

shell folderify --macOS 11.0 --color-scheme dark mask.png

Note:

• There is currently no simple way to set an icon that will automatically switch between light and dark when you switch the entire OS. You can only assign one version of an icon to a folder.
• Dark color scheme is only supported for macOS 11.0 (and later) right now.

Tips

For best results:

• Use a .png mask.
• Use a solid black design over a transparent background.
• Make sure the corner pixels of the mask image are transparent. They are used for empty margins.
• Pass the --no-trim flag and use a mask:
  • with a height of 384px,
  • with a width that is a multiple of 128px (up to 768px),
  • using a 16px grid.
  • Each 64x64 tile will exactly align with 1 pixel at the smallest icon size.

Other installation options

If you don't have Homebrew but you already have ImageMagick (the convert binary) on your system, you can use the following:

Install using Rust

shell cargo install folderify

From source

Or download the code directly:

```shell git clone https://github.com/lgarron/folderify && cd folderify

Run directly

cargo run -- --reveal examples/src/folder_outline.png .

Install (assuming the cargo bin is in your path)

cargo install --path . folderify --reveal examples/src/folder_outline.png . ```

The repository folder should now have a custom icon.

shell for file in examples/src/*.png; do cargo run -- folderify $file; done open examples/src/

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

Dependencies

• ImageMagick - for image processing (you should be able to run convert and identify on the commandline).
• Included with macOS:
  • iconutil
• sips, DeRez, Rez, SetFile (You need XCode command line tools for some of these.)

Full options

``` Generate a native-style macOS folder icon from a mask file

Usage: folderify [OPTIONS] [TARGET]

Arguments: Mask image file. For best results: - Use a .png mask. - Use a solid black design over a transparent background. - Make sure the corner pixels of the mask image are transparent. They are used for empty margins. - Make sure the non-transparent pixels span a height of 384px, using a 16px grid. If the height is 384px and the width is a multiple of 128px, each 64x64 tile will exactly align with 1 pixel at the smallest folder size. [TARGET] Target file or folder. If a target is specified, the resulting icon will be applied to the target file/folder. Else, a .iconset folder and .icns file will be created in the same folder as the mask (you can use "Get Info" in Finder to copy the icon from the .icns file).

Options: -r, --reveal Reveal the target (or resulting .icns file) in Finder --macOS Version of the macOS folder icon, e.g. "10.13". Defaults to the version currently running --color-scheme Color scheme — auto matches the current system value [default: auto] [possible values: auto, light, dark] --no-trim Don't trim margins from the mask. By default, transparent margins are trimmed from all 4 sides. --set-icon-using Legacy argument. Now ignored. -v, --verbose Detailed output -h, --help Print help -V, --version Print version ```

Example generated from the Apple logo: