# Install fileicon with Homebrew macOS CLI for managing custom icons for files and folders. Version 0.3.5 via Homebrew; verified 2026-05-11. ## Install ```sh sudo av install brew:fileicon ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install fileicon ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:fileicon - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.3.5 - **Source summary:** macOS CLI for managing custom icons for files and folders - **Homepage:** - **Repository:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-05-11T00:41:58Z - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - fileicon (cli) - fileicon (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-08-04 - Package-manager version: 0.3.5 - Package-manager updated: 2026-05-11 - Local data: ok - Upstream repository: https://github.com/mklement0/fileicon - Upstream latest detected: v0.3.5 (current) ## Project history and usage fileicon is a macOS command-line utility for setting, removing, extracting, and testing custom icons on files and folders. ### Project history fileicon began with an initial v0.1.0 release on August 3, 2015. Its README and generated manual explain that it provides a programmatic alternative to using Finder for custom icons, storing icon data through macOS filesystem metadata. ### Adoption history The README documents Homebrew, npm, and manual installation. Its changelog credits Homebrew formula availability in late 2019 and later macOS compatibility work for Monterey and Ventura-era behavior. ### How it is used The CLI exposes set, rm, get, and test subcommands. Users provide a target file or folder and, for set, an image file; the tool creates square icon representations and applies macOS custom-icon metadata. ### Why package nerds care fileicon is a good example of package managers distributing a narrow macOS automation tool that wraps platform-specific metadata behavior behind a scriptable CLI, with both Homebrew and npm installation paths documented by the maintainer. ### Timeline - 2015: Initial v0.1.0 release. - 2017: v0.2.0 added macOS High Sierra support and changed icon generation internals. - 2019: Homebrew installation became available. - 2022: v0.3.x adjusted for macOS Monterey Python changes and volume icons. - 2026: v0.3.5 released according to the official changelog. ### Related projects - The README references Icon Changer as a GUI utility that uses fileicon behind the scenes. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for fileicon. Package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** fileicon - **Version Scheme:** 0 - **Revision:** 0 - **Requirements:** macos - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://pkg.so/brew-utility-packages/) - Matched Homebrew package provider. - [osxutils](https://pkg.so/brew/osxutils/) - Shares pkgdb curated category or tags: cli, finder, macos, system. - [mole](https://pkg.so/brew/mole/) - Shares pkgdb curated category or tags: cli, macos, system. - [mas](https://pkg.so/brew/mas/) - Shares pkgdb curated category or tags: cli, macos, system. - [osx-cpu-temp](https://pkg.so/brew/osx-cpu-temp/) - Shares pkgdb curated category or tags: cli, macos, system. - [sleepwatcher](https://pkg.so/brew/sleepwatcher/) - Shares pkgdb curated category or tags: cli, macos, system. - [m-cli](https://pkg.so/brew/m-cli/) - Shares pkgdb curated category or tags: cli, macos, system. - [reattach-to-user-namespace](https://pkg.so/brew/reattach-to-user-namespace/) - Shares pkgdb curated category or tags: cli, macos, system. - [mist-cli](https://pkg.so/brew/mist-cli/) - Shares pkgdb curated category or tags: cli, macos, system. - [ddh](https://pkg.so/brew/ddh/) - Local package facts share a topical domain. Shared terms: cli, file, file-management, files, finder. - [rmtrash](https://pkg.so/brew/rmtrash/) - Local package facts share a topical domain. Shared terms: cli, file, file-management, files, macos. - [czkawka](https://pkg.so/brew/czkawka/) - Local package facts share a topical domain. Shared terms: cli, file, file-management, files, management. ## Combined YAML source View the package source record on GitHub. [combined/fileicon.yml](https://github.com/mxcl/pkgdb/blob/main/combined/fileicon.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - cross-ecosystem install command graph