folderify
brew install folderify
v4.1.3
MIT
Generate pixel-perfect macOS folder icons in the native style
48
30-day installs · #4785
202
90-day · #4181
1.8k
365-day · #2954
1.9k
★ GitHub stars · updated 3mo ago
Runtime dependencies
Build dependencies
GitHub topics
big-sur
dark-mode
folder
graphics
icns
icons
macos
monterey
osx
rust
sequoia
sonoma
tahoe
ventura
Links
- https://github.com/lgarron/folderify
- GitHub: lgarron/folderify
- Brew formula source: Formula/f/folderify.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [
"rust"
],
"categories": [],
"caveats": null,
"conflicts_with": [],
"dependencies": [
"imagemagick"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Generate pixel-perfect macOS folder icons in the native style",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:37:45+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "folderify",
"github_default_branch": "main",
"github_last_commit_at": "2026-05-18T21:01:24Z",
"github_readme_excerpt": "# folderify\n\n\n\nGenerate pixel-perfect macOS folder icons in the native style (including for macOS 26 Tahoe).\n\n- Automatically includes all icon sizes from `16x16` through `512x512@2x`.\n- Light or dark mode (automatically selected by default).\n\n**Using `folderify`?** [Let me know](https://mastodon.social/@lgarron) or [let me know](https://github.com/lgarron/folderify/issues/new) and I\u0027d love to feature some real-world uses!\n\n## Install\n\nInstall `folderify` using [Homebrew](https://formulae.brew.sh/formula/folderify):\n\n```shell\nbrew install folderify\n```\n\nHomebrew install is recommended, and automatically installs `folderify` argument completions for your shell.\n\nSee below for other installation options.\n\n## Usage\n\nUse a mask to assign an icon to a folder:\n\n```shell\nfolderify mask.png /path/to/folder\n```\n\nGenerate `mask.icns` and `mask.iconset` files:\n\n```shell\nfolderify mask.png\n```\n\nBy default, `folderify` uses your system\u0027s current light/dark mode. Use `--color-scheme` to override this:\n\n```shell\nfolderify --color-scheme dark mask.png\n```\n\nNote:\n\n- 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.\n\n### Tips\n\nFor best results:\n\n- Use a `.png` mask.\n- Use a solid black design over a transparent background.\n- Make sure the corner pixels of the mask image are transparent. They are used for empty margins.\n- Pass the `--no-trim` flag and use a mask:\n - with a height of 384px,\n - with a width that is a multiple of 128px (up to 768px),\n - using a 16px grid.\n - Each 64x64 tile will exactly align with 1 pixel at the smallest icon size.\n\n### OS X (macOS 10)\n\nFolder styles from OS X / macOS 10 are no longer supported by `folderify` as of v3:\n\n- Leopard-style (OS X 10.5 to OS X 10.9)\n- Yosemite-style (OS X 10.10 to macOS 10.15)\n\nTo generate these, please use `folderif",
"github_repo": "lgarron/folderify",
"github_stars": 1933,
"github_topics": [
"big-sur",
"dark-mode",
"folder",
"graphics",
"icns",
"icons",
"macos",
"monterey",
"osx",
"rust",
"sequoia",
"sonoma",
"tahoe",
"ventura"
],
"homepage": "https://github.com/lgarron/folderify",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 48,
"installs_365d": 1817,
"installs_90d": 202,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "folderify",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 4785,
"rank_365d": 2954,
"rank_90d": 4181,
"raw_hash": "49764fa0903144b5",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/f/folderify.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "4.1.3",
"versioned_formulae": [],
"why_use_this": null
}