macOS
Homebrewverified · 100%
brew install fileiconlocal Homebrew formula metadata
brew / rank 2379
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
Additional install commands
overview
Package summary
macOS CLI for managing custom icons for files and folders
Project links
Commands and aliases
- fileicon
history
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 posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for fileicon. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 1 platform targets.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
fileicon | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-04
manager version0.3.5
manager updated2026-05-11
local dataok
upstreamcurrent
latest detectedv0.3.5
https://github.com/mklement0/fileicon
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:fileicon |
|---|---|
| Version | 0.3.5 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/fileicon |
| Homepage | https://github.com/mklement0/fileicon |
| Repository | https://github.com/mklement0/fileicon |
| License | MIT |
| Source archive | https://github.com/mklement0/fileicon/archive/refs/tags/v0.3.5.tar.gz |
| Last updated | 2026-05-11T00:41:58Z |
| Pulse | updated |
| Bottle | available (on all) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | fileicon |
| Version Scheme | 0 |
| Revision | 0 |
| Requirements |
|
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment
- pkg.so package database
- pkgdb category and tag curation