Skip to main content

A tool to generate pretty, beveled OSX folder icons.

Project description

# folderify

![Apple Folder](examples/png/apple_folder_256.png)
![Cube Folder](examples/png/cube_folder_256.png)
![Octocat Folder](examples/png/octocat_folder_256.png)
![Rhombic Hexecontrahedron Folder](examples/png/rhombic_hexecontahedron_folder_256.png)
![Octocat Folder](examples/png/sysprefs_folder_256.png)


![apple.gif](examples/png/apple.gif)

# Try it!

git clone git://github.com/lgarron/folderify.git
cd folderify
for file in examples/src/*.png; do python -m 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.

Or try this:

git clone git://github.com/lgarron/folderify.git
cd folderify
python -m folderify examples/src/folder_outline.png .

The repository folder should now have an icon.

## Usage

Generate a native OSX folder icon from a mask file.

./folderify -h
usage: folderify [-h] [--reveal] [--pre-yosemite] mask [target]

Generate a native OSX 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 icon is at least around 1024x1024, in order to look good at maximum Retina resolution.
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 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.
--pre-yosemite Generate pre-Yosemite folder icons.

### Dependencies

- [ImageMagick](http://www.imagemagick.org/) - for image processing (you should be able to run <code>convert</code> on the commandline).
- Python 2 - to help assign the icon file to itself.
- Apple Developer Tools (for `iconutil`)

## Pre-Yosemite

If you'd like to generate old folder icons, use `folderify.py` with the `--pre-yosemite` flag.

## Info

`GenericFolderIcon.iconset` is generated from the OSX default folder icon using:

iconutil --convert iconset --output GenericFolderIcon.iconset "/System/Library/CoreServices/CoreTypes.bundle/Contents/Resources/GenericFolderIcon.icns"

Icons are set using [`osxiconutils`](http://www.sveinbjorn.org/osxiconutils), a GPL-licensed project by Sveinbjorn Thordarson (based on [`IconFamily`](http://iconfamily.sourceforge.net/)).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

folderify-0.0.5.tar.gz (3.1 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page