Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lgarron/folderify
:file_folder: Generate pixel-perfect macOS folder icons in the native style.
https://github.com/lgarron/folderify
big-sur dark-mode folder graphics icns icons macos monterey osx rust sonoma ventura
Last synced: 4 days ago
JSON representation
:file_folder: Generate pixel-perfect macOS folder icons in the native style.
- Host: GitHub
- URL: https://github.com/lgarron/folderify
- Owner: lgarron
- License: mit
- Created: 2011-09-04T01:49:16.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2024-09-27T10:44:52.000Z (3 months ago)
- Last Synced: 2024-12-16T02:47:56.998Z (6 days ago)
- Topics: big-sur, dark-mode, folder, graphics, icns, icons, macos, monterey, osx, rust, sonoma, ventura
- Language: Rust
- Homepage:
- Size: 12.6 MB
- Stars: 1,577
- Watchers: 23
- Forks: 39
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred-test - lgarron/folderify - :file_folder: Generate pixel-perfect macOS folder icons in the native style. (Rust)
README
# folderify
Generate pixel-perfect macOS folder icons in the native style.
- Automatically includes all icon sizes from `16x16` through `512x512@2x`.
- Light or dark mode (automatically selected by default).
**Using `folderify`?** [Let me know](https://mastodon.social/@lgarron) or [let me know](https://github.com/lgarron/folderify/issues/new) and I'd love to feature some real-world uses!
## Install
Install `folderify` using [Homebrew](https://formulae.brew.sh/formula/folderify):
```shell
brew install folderify
```
Homebrew install is recommended, and automatically installs `folderify` argument completions for your shell.
See below for other installation options.
## 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
```
By default, `folderify` uses your system's current light/dark mode. Use `--color-scheme` to override this:
```shell
folderify --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.
### 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.
### OS X (macOS 10)
Folder styles from OS X / macOS 10 are no longer supported by `folderify` as of v3:
- Leopard-style (OS X 10.5 to OS X 10.9)
- Yosemite-style (OS X 10.10 to macOS 10.15)
To generate these, please use `folderify` v2. For example:
```shell
pip3 install folderify
python3 -m folderify --macOS 10.5 path/to/icon.png
```
## Other installation options
If you don't have Homebrew but you already have ImageMagick (the `magick`
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 -- $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](https://www.imagemagick.org/) - for image processing (you should be able to run `magick` and `identify` on the commandline).
- Included with macOS:
- `iconutil`
- Optional:
- [`fileicon`](https://github.com/mklement0/fileicon/)
- `sips`, `DeRez`, `Rez`, `SetFile` (You need Xcode command line tools for some of these.)
## Full options
````cli-help
Generate a native-style macOS folder icon from a mask file.
Usage: folderify [OPTIONS] [MASK] [TARGET]
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 (unless --output-icns or
--output-iconset is specified), 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:
--output-icns
Write the `.icns` file to the given path.
(Will be written even if a target is also specified.)
--output-iconset
Write the `.iconset` folder to the given path.
(Will be written even if a target is also specified.)
-r, --reveal
Reveal either the target, `.icns`, or `.iconset` (in that order of preference) in Finder
--macOS
Version of the macOS folder icon, e.g. "14.2.1". 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 (i.e. without this flag), transparent margins are trimmed from all 4 sides.
--no-progress
Don't show progress bars
--badge
Add a badge to the icon. Currently only supports one badge at a time
[possible values: alias, locked]
-v, --verbose
Detailed output. Also sets `--no-progress`
--completions
Print completions for the given shell (instead of generating any icons).
These can be loaded/stored permanently (e.g. when using Homebrew), but they can also be sourced directly, e.g.:
folderify --completions fish | source # fish
source <(folderify --completions zsh) # zsh
[possible values: bash, elvish, fish, powershell, zsh]
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
````
## Example
Example generated from the Apple logo:
