{"repo":"mklement0/fileicon","free":true,"listed":false,"github":"https://github.com/mklement0/fileicon","clone":"git clone https://github.com/mklement0/fileicon.git","description":"macOS CLI for managing custom icons for files and folders","language":"Shell","stars":534,"topics":["cli","macos","icons","custom-icon","filesystem"],"license":null,"category":"cli-tools","readme_excerpt":"Contents - fileicon — introduction - Examples - Installation - Installation via Homebrew - Installation from the npm registry - Manual installation - Usage - License - Acknowledgements - npm dependencies - Changelog fileicon — introduction fileicon is a macOS CLI for managing custom icons for files and folders, as a programmatic alternative to interactively using Finder. fileicon allows assigning a custom icon to any file or folder, using any image file whose format is recognized by the system. Caveats : Custom icons rely on extended attributes of the macOS filesystems, HFS+ and APFS. Therefore, custom icons are lost when copying files or folders to filesystems that don't support these attributes; for instance, custom icons cannot be stored in a Git repository. 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 me; see this Ask Different question, for instance. When assigning an image file with fileicon set , a set of icons in several resolutions is created and stored in the resource fork of the target file itself / of a hidden Icon\\r file inside the target folder / as the content of a hidden .VolumeIcon.icns file for folders that are volume mountpoints . Addtionally, a com.apple.FinderInfo extended attribute with the custom-icon attribute (flag) is set on the target file or folder itself. The icon with the highest resolution measure","default_branch":null,"files":null,"tree":[],"storefront":"/r/mklement0","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/mklement0/fileicon/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}