:file_folder: Generate pixel-perfect macOS folder icons in the native style. Ready for macOS 11.0 Big Sur.
Generate pixel-perfect macOS folder icons in the native style.
16x16through
[email protected].
Using
folderify? Let me know or let me know and I'd love to feature some real-world uses!
brew install folderify
Use a mask to assign an icon to a folder:
folderify mask.png /path/to/folder
Generate
mask.icnsand
mask.iconsetfiles:
folderify mask.png
Generate icon files for a specific version of macOS (the default is your current version):
folderify --macOS 11.0 mask.png
By default,
folderifyuses your systems's current light/dark mode. Use
--color-schemeto override this:
folderify --macOS 11.0 --color-scheme dark mask.png
Note: - Dark color scheme is only supported for macOS 11.0 right now. - 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 icon to a folder.
For best results:
.pngmask.
--no-trimflag and use a mask:
If you don't have Homebrew but you already have ImageMagick (the
convertbinary) on your system, you can use the following:
pip
pip install folderify
Or download the code directly:
curl -L https://github.com/lgarron/folderify/archive/main.zip -o folderify-main.zip unzip folderify-main.zip && cd folderify-main python -m folderify examples/src/folder_outline.png . --reveal
The repository folder should now have a custom icon.
for file in examples/src/*.png; do python -m folderify $file; done open examples/src/
You should see a bunch of new
.iconsetfolders and
.icnsfiles that were automatically generated from the
.pngmasks.
convert
on the commandline).iconutil
folderify:
osxiconutils, a GPL-licensed project by Sveinbjorn Thordarson (based on
IconFamily).
usage: folderify [-h] [--reveal] [--macOS VERSION] [--osx VERSION] [--color-scheme COLOR_SCHEME] [--no-trim] [--verbose] [mask] [target] Generate a native-style macOS folder icon from a mask file.positional arguments: mask 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).
optional arguments: -h, --help show this help message and exit --reveal, -r Reveal the target (or resulting .icns file) in Finder. --macOS VERSION Version of the macOS folder icon, e.g. "10.13". Defaults to the version currently running (10.15). --osx VERSION, -x VERSION Synonym for the --macOS argument. --color-scheme COLOR_SCHEME Color scheme: auto (match current system), light, dark. --no-trim Don't trim margins from the mask. By default, transparent margins are trimmed from all 4 sides. --verbose, -v Detailed output.
Example generated from the Apple logo: