🍺 BREW Explorer

← all formulae

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

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![mask.png + folder = folderified!](examples/png/explanation-tahoe.png)\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
}