{"id":13479083,"url":"https://github.com/FrancesCoronel/customize-icons","last_synced_at":"2025-03-27T09:30:59.307Z","repository":{"id":78858974,"uuid":"49301653","full_name":"FrancesCoronel/customize-icons","owner":"FrancesCoronel","description":"Customize your icons on macOS 🔧","archived":true,"fork":false,"pushed_at":"2017-01-26T16:39:29.000Z","size":32122,"stargazers_count":8,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-01T16:55:34.556Z","etag":null,"topics":["custom-icon","finder","hidden-files","icon","icons","macos"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FrancesCoronel.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeIcons.command","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-01-08T23:06:34.000Z","updated_at":"2023-06-10T01:23:09.000Z","dependencies_parsed_at":"2023-07-04T07:17:37.322Z","dependency_job_id":null,"html_url":"https://github.com/FrancesCoronel/customize-icons","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrancesCoronel%2Fcustomize-icons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrancesCoronel%2Fcustomize-icons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrancesCoronel%2Fcustomize-icons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FrancesCoronel%2Fcustomize-icons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FrancesCoronel","download_url":"https://codeload.github.com/FrancesCoronel/customize-icons/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222222202,"owners_count":16951399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-icon","finder","hidden-files","icon","icons","macos"],"created_at":"2024-07-31T16:02:08.975Z","updated_at":"2025-03-27T09:30:59.260Z","avatar_url":"https://github.com/FrancesCoronel.png","language":"Ruby","funding_links":["http://paypal.me/fvcproductions"],"categories":["Ruby"],"sub_categories":[],"readme":"# customize-icons\n\n[![Github Issues](http://githubbadges.herokuapp.com/fvcproductions/customize-icons/issues.svg?style=flat-square)](https://github.com/fvcproductions/customize-icons/issues) [![Pending Pull-Requests](http://githubbadges.herokuapp.com/fvcproductions/customize-icons/pulls.svg?style=flat-square)](https://github.com/fvcproductions/customize-icons/pulls) [![License](http://img.shields.io/:license-mit-blue.svg?style=flat-square)](http://badges.mit-license.org)\n\n## Use the `ChangeIcons.command` in this folder to customize and change your macOS app icons in a jiffy.\n\nEl Capitan introduced a new security policy preventing users from changing any system icon.\n\nHowever, you can still continue to change your apps and volumes icons normally.\n\nApps like `LiteIcon` still work pretty well for this sort of thing, but it requires a lot of manual dragging.\n\nIf you're like me and enjoy using the `Terminal` to automate work-flows, I think you'll enjoy what's to follow.\n\n## Installation\n\n### Step 1 - Download Icons\n\n[DeviantArt](http://www.deviantart.com) is my go-to place for icons sets, but you can also try [IconArchive](http://www.iconarchive.com/) for a broader range of options.\n\n## Step 2 - Edit Files\n\nI include this command file in the repo under `ChangeIcons.command`\n\nNow here comes the tricky part.\n\nThis command relies on a `JSON` file that is named `icon-data.json` and a `UNIX Executable File` called `setfileicon`.\n\n![All The Icons Folder Screenshot - 1](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-28-23-10-54.png)\n\n![All The Icons Screenshot - 2](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-28-23-11-18.png)\n\nThese files are both included in a folder called `set_icon` in the [`ZIP` file](https://github.com/fvcproductions/customize-icons) provided in **Step 1**. The `icon-data.json` file looks something like this:\n\n```json\n\n{\n    \"1Password 5.app\":\"1Password 5\",\n    \"Alfred 2.app\":\"Alfred 2\",\n    \"Amphetamine.app\":\"Amphetamine\"\n}\n\n```\n\nIt is formatted with the name of the app first in quotes followed by a semi-colon and then the name of the `icns` file.\n\nEdit this `icon-data.json` file to include your own apps or create it yourself using your favorite text-editor.\n\nHere is how the `JSON` file for the Utilities looks like.\n\n![JSON file](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-28-23-49-06.png)\n\nIt is `case-sensitive`, so make sure to type everything correctly to suit what the app is called and what you named the corresponding `icns` file.\n\n\u003e When you are editing this file to add on your own apps, make sure there’s not a comma on the last line or there will be an error.\n\nNow, using `Terminal`, type in the following: `defaults write com.apple.finder AppleShowAllFiles YES`.\n\nOnce you press `Enter`, this command will show all the hidden files on your Mac.\n\nI would not recommend messing with any of these hidden files.\n\nThe reason Apple hides them is so that the user has less of a chance of messing things up.\n\n\u003e To make the files hidden again later, type in the same command but with a NO at the end like this: `defaults write com.apple.finder AppleShowAllFiles NO`.\n\nAfter that, type in `killall Finder` into Terminal for the command to restart the Finder and have the hidden files be revealed in your Finder.\n\n[![Show Hidden Files Command in Terminal](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-21-37.png)](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-21-37.png)\n\nNow that you have your Finder revealing all the hidden files - in the folder where you have all your icons properly named, copy and paste the folder `set_icons` from the [`ZIP` file](https://github.com/fvcproductions/customize-icons \"Icons\") mentioned in **Step 1**, and rename it to `.set_icons`.\n\nAdding a period in front of the folder name makes it hidden and you will therefore not be able to see it anymore.\n\nIt looks exactly like the `.set_icons` folder already included within the folder called `Utilities` that can be found in the [`ZIP` file](https://github.com/fvcproductions/customize-icons \"Icons\").\n\n![Utility Sub-Folder](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-28-23-11-42.png)\n\nSo if you want to change your Utility icons as well, the `.set_icons` folder located in the sub-folder `Utilities` already has the `json` file with all the necessary modifications.\n\n\u003e The only difference between the `ChangeIcons.command` within the `All The Icons` folder and the `ChangeUtilityIcons.command located within the`Utilities folder`is that on Line 36, the app path is listed as`app_path = “/Applications/Utilities/#{key}”`.\n\n## Step 3 - Edit Command\n\nNow you probably have something like the following:\n\n*   a folder called `All The Icons` with\n    *   all the icons you want to replace your old ones (in `icns` format)\n    *   the `ChangeIcons.command` that was included in this [`ZIP` file](https://github.com/fvcproductions/customize-icons \"Icons\")\n    *   a _hidden_ sub-folder called `.set_icons` with\n        *   a modified `icon-data.json` file to include your own personal apps\n        *   the `setfileicon` UNIX executable file\n\nAt this point, if you’ve done everything right, you can “hide” your hidden files again in your Finder by executing the command `defaults write com.apple.finder AppleShowAllFiles NO` in `Terminal`.\n\nMake sure to execute `killall Finder` as well so that your Finder restarts and shows the changes.\n\nNow go ahead and click the `ChangeIcons.command` to change all your icons simultaneously.\n\n[![ChangeIcons.command in Terminal](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-01-44.png)](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-01-44.png)\n\nYou will be prompted to enter your password and **walla** you have all your snazzy new icons in place in seconds!\n\n### Troubleshooting\n\n- You tried to edit the command files and now have a syntax error, like in the form of quotes - just make sure to use _straight quotes_.\n- You have a syntax error in your `icon-data.json` file, like a comma on the last line.\n- You forgot to include a certain app in your `icon-data.json` file and so the icon does not change when you execute the command.\n- An app is locked and, therefore, the icon cannot be changed. To unlock an app, go to the app, right click,  `Get Info`. Uncheck the `Locked` button.\n\n![Locked App Error In Terminal](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-01-54.png)\n\n![Locked App - Dropbox](https://fvcproductions.files.wordpress.com/2015/03/screenshot-2015-03-29-00-09-37.png)\n\n## Contributing\n\nThis is the `icon_data.json`. This contains all the necessary information the Unix executable file `setfileicon` will need to change your Mac App icons. You will never be able to see either of these files because they are hidden in a system folder called `.set_icons`. To be able to view and edit these files, you will have to run the following 2 commands in `Terminal` to temporarily reveal all hidden folders/files:\n\n```bash\n$ defaults write com.apple.finder AppleShowAllFiles YES\n$ killall Finder\n```\n\nTo undo this, enter the following into `Terminal`:\n\n```bash\n$ defaults write com.apple.finder AppleShowAllFiles NO\n$ killall Finder\n```\n\n\u003e On the left we have the name of the Mac App with the `.app` extension.\n\n\u003e On the right we have the actual name of the icon we want to use for that Mac App except without the extension of the image which should always be a `.icns` extension\n\n```json\n{\n    \"1Checker.app\": \"Calibre\",\n    \"1Password 5.app\": \"1Password 5\",\n    \"Alchemize.app\": \"Alchemize\",\n    \"Alfred 2.app\": \"Alfred 2\",\n    // and so on\n}\n```\n\nSo if we wanted to add an icon for the **Ember** Mac App, then we would just add the following line right after the line that has **EasyImageConverter** (so that it stays in alphabetical order):\n\n```json\n    \"Ember.app\": \"Ember\",\n```\n\nThere would have to be a file called `Ember.icns` in the directory and the user would need the `Ember.app` installed on their Mac's `Applications` directory for this icon change to actually work.\n\nIf Ember wasn't installed, then the script would just skip that line.\n\n**To submit a successful pull request**, you have to do the following:\n\n## Credits\n\n- [Sebastian de With](http://dewith.com/)\n- [Yoios](https://github.com/mmarfil/yoios)\n- [James Moore](https://twitter.com/foozmeat)\n- [FVCproductions](http://fvcproductions.com)\n\n## Donations\n\n\u003e Feed me... 🍕\n\n[![Donate via PayPal](https://raw.github.com/xioTechnologies/PayPal-Button/master/PayPal%20Button.png)](http://paypal.me/fvcproductions)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFrancesCoronel%2Fcustomize-icons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFrancesCoronel%2Fcustomize-icons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFrancesCoronel%2Fcustomize-icons/lists"}