# 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
- **Version:** 0.3.5
- **Source summary:** macOS CLI for managing custom icons for files and folders
- **Homepage:** <https://github.com/mklement0/fileicon>
- **Repository:** <https://github.com/mklement0/fileicon>
- **Last updated:** 2026-05-11T00:41:58Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- fileicon (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.3.5
## 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

- <https://api.github.com/repos/mklement0/fileicon>
- <https://formulae.brew.sh/api/formula/fileicon.json>
- <https://github.com/mklement0/fileicon>
- <https://raw.githubusercontent.com/mklement0/fileicon/master/README.md>
- <https://raw.githubusercontent.com/mklement0/fileicon/master/doc/fileicon.md>


## Security Notes

No matching local secret-handling manifest was found for fileicon. Nucleus package metadata is still published here so future coverage has a stable package URL.



## 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
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph