fileicon

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "macOS CLI for managing custom icons for files and folders",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:37:38+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "fileicon",
  "github_default_branch": "master",
  "github_last_commit_at": "2026-05-10T20:28:18Z",
  "github_readme_excerpt": "[![npm version](https://img.shields.io/npm/v/fileicon.svg)](https://npmjs.com/package/fileicon) [![license](https://img.shields.io/npm/l/fileicon.svg)](https://github.com/mklement0/fileicon/blob/master/LICENSE.md)\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON\u0027T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n**Contents**\n\n- [fileicon \u0026mdash; introduction](#fileicon-mdash-introduction)\n- [Examples](#examples)\n- [Installation](#installation)\n  - [Installation via Homebrew](#installation-via-homebrew)\n  - [Installation from the npm registry](#installation-from-the-npm-registry)\n  - [Manual installation](#manual-installation)\n- [Usage](#usage)\n- [License](#license)\n  - [Acknowledgements](#acknowledgements)\n  - [npm dependencies](#npm-dependencies)\n- [Changelog](#changelog)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n# fileicon \u0026mdash; introduction\n\n`fileicon` is a macOS CLI for managing custom icons for files and folders, as \na programmatic alternative to interactively using Finder.\n\n`fileicon` allows assigning a custom icon to any file or folder,\nusing [any image file whose format is recognized by the system](https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/CocoaDrawingGuide/Images/Images.html#//apple_ref/doc/uid/TP40003290-CH208-BCIIFBJG).\n\n_Caveats_: \n * Custom icons rely on [extended attributes](https://en.wikipedia.org/wiki/Extended_file_attributes#OS_X) of the macOS filesystems, \n[HFS+](https://en.wikipedia.org/wiki/HFS_Plus) and [APFS](https://en.wikipedia.org/wiki/Apple_File_System).\nTherefore, custom icons are lost when copying files or folders to filesystems that don\u0027t\nsupport these attributes; for instance, custom icons cannot be stored in a Git repository.\n\n* v0.3.2+ supports custom icons for _volumes_ (folders that act as volume mountpoints) _in principle_, but, as of macOS 13.1 (Ventura), this often fails in practice, for reasons unknown to",
  "github_repo": "mklement0/fileicon",
  "github_stars": 531,
  "github_topics": [
    "cli",
    "custom-icon",
    "filesystem",
    "icons",
    "macos"
  ],
  "homepage": "https://github.com/mklement0/fileicon",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 444,
  "installs_365d": 2873,
  "installs_90d": 1421,
  "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": "fileicon",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 1871,
  "rank_365d": 2441,
  "rank_90d": 1858,
  "raw_hash": "bfe6a9ab6241519a",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/f/fileicon.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": null,
  "version_stable": "0.3.5",
  "versioned_formulae": [],
  "why_use_this": null
}