{"id":17689209,"url":"https://github.com/othyn/github-folder-icon-macos","last_synced_at":"2025-08-20T10:32:19.251Z","repository":{"id":29182538,"uuid":"120453482","full_name":"othyn/github-folder-icon-macOS","owner":"othyn","description":"GitHub folder icon for use in macOS. Made so that it fits nicely alongside all the others inside your home directory. Mac OS X 10.5 (Leopard) through to macOS 15 (Sequoia).","archived":false,"fork":false,"pushed_at":"2024-10-06T11:03:39.000Z","size":31411,"stargazers_count":60,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-12-11T10:37:15.821Z","etag":null,"topics":["dark-mode","folder-icon","folderify","github","github-icons","icon","icon-pack","icon-packs","icons","light-mode","macos","macos-icon","macos-icons"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/othyn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-06T12:33:24.000Z","updated_at":"2024-12-02T03:25:59.000Z","dependencies_parsed_at":"2023-01-14T14:30:38.301Z","dependency_job_id":null,"html_url":"https://github.com/othyn/github-folder-icon-macOS","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othyn%2Fgithub-folder-icon-macOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othyn%2Fgithub-folder-icon-macOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othyn%2Fgithub-folder-icon-macOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othyn%2Fgithub-folder-icon-macOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/othyn","download_url":"https://codeload.github.com/othyn/github-folder-icon-macOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230415318,"owners_count":18222158,"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":["dark-mode","folder-icon","folderify","github","github-icons","icon","icon-pack","icon-packs","icons","light-mode","macos","macos-icon","macos-icons"],"created_at":"2024-10-24T11:46:53.926Z","updated_at":"2024-12-19T10:09:42.763Z","avatar_url":"https://github.com/othyn.png","language":"Makefile","readme":"# 🍏📁 macOS GitHub Folder Icon\n\nMade so that it fits nicely alongside all the others inside your home directory... or wherever.\n\nWhat do we have here...\n\n- ... 📈 A version available all the way from Mac OS X 10.5 (Leopard) through to macOS 15 (Sequoia)\n- ... 🌗 Light and Dark mode variants (where applicable, macOS 11 or later)\n- ... 📁 Both `icns` and `iconset` versions of all icons\n- ... 🖼️ All icon sizes from `16x16` through to `512x512@2x`\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg src=\"art/preview_old.png\" width=\"25%\" alt=\"the oldest Mac OS X icon\" /\u003e\n  \u0026nbsp;\n  \u003cimg src=\"art/arrow.png\" width=\"10%\" alt=\"an arrow pointing right\" /\u003e\n  \u0026nbsp;\n  \u003cimg src=\"art/preview_new.png\" width=\"25%\" alt=\"the newest macOS icon\" /\u003e\n\u003c/p\u003e\n\n## 👇 Downloading \u0026 using the icon(s)\n\n### 🐌 The manual way\n\nThe easiest way will be for you to download the icon you want from the the [`icons`](./icons) directory. Simply find which macOS version you would like the icon for, and if applicable the light or dark mode variant, and download the `icns` file within that directory using GitHub's Download button once within a file's context:\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg src=\"art/download.png\" width=\"75%\" alt=\"GitHub's download button\" /\u003e\n\u003c/p\u003e\n\nTo apply the icon, right click on the directory that you wish to update the icon of and click 'Get Info', a new dialogue window should appear. You now need to click-and-drag the downloaded `icns` file into the small icon in the top left of the window next to the directory name:\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg src=\"art/get_info.png\" width=\"30%\" alt=\"macOS 'Get Info' dialogue window\" /\u003e\n\u003c/p\u003e\n\nTa-da! 🎉 You're all set, the icon should now be looking glorious.\n\n### 🚀 The fun way\n\nThere's a brilliant tool called [`fileicon`](https://github.com/mklement0/fileicon) in which can programmatically set the icons of files and folders in macOS.\n\nTo install it via [`brew`](https://brew.sh/):\n\n```sh\nbrew install fileicon\n```\n\nThen, if we assume that the directory we want to set the icon for is `~/git` and the downloaded icon resides in `~/Downloads/icon.icns`:\n\n```sh\n# Assign the custom downloaded GitHub icon to ~/git\nfileicon set ~/git ~/Downloads/icon.icns\n```\n\nTa-da! 🎉 You're all set, the icon should now be looking glorious.\n\nTo restore the icon to its original state:\n\n```sh\n# Remove the custom downloaded GitHub icon from ~/git\nfileicon rm ~/git\n```\n\nMore examples can be found under the [Examples heading in the `fileicon` README](https://github.com/mklement0/fileicon#examples).\n\n## 🧰 Installing dependencies\n\nI used to manually find and extract the folder icon upon every release, but someone recently introduced me to... [`folderify`](https://github.com/lgarron/folderify)! Which has made maintaining this repo a breeze.\n\nMake sure [`brew`](https://brew.sh/) is installed (don't want to automate installing this on your system) and then go ahead and run the `make` command to get things setup:\n\n```sh\nmake install\n```\n\n## 🏗️ Generating icons\n\nThis is as simple as ensuring that you've already run `make install` and then running:\n\n```sh\nmake icons\n```\n\n### 🎨️ Manually generating just the icons\n\nTo generate just the icons on their own, run:\n\n```sh\nmake generate\n```\n\nAlthough this step is run prior to generating new icons anyway.\n\n### 🖼️ Manually generating a new preview image\n\nTo generate a new preview image, used in the README of this project, run:\n\n```sh\nmake preview\n```\n\nAlthough this step is run prior to generating new icons anyway.\n\n### 🗑️ Manually cleaning Icons\n\nIf you want to quickly wipe the slate clean, run:\n\n```sh\nmake clean\n```\n\nAlthough this step is run prior to generating new icons anyway.\n\n## ❓ F.A.Q's\n\n- Can I get the icon to automatically change with light/dark mode?\n\n  - Unfortunately, no. As mentioned in the [Folderify README, under Usage](https://github.com/lgarron/folderify#usage):\n\n    \u003e There is currently no simple way to set an icon that will automatically switch between light and dark when you switch the entire OS. You can only assign one icon to a folder.\n\n  - This appears to be a limitation within macOS itself and Apple currently not allowing for the distinction between two icons\n\n## 🎂 Sources\n\n- Amazing GitHub icon: [Dave Gandy on flaticon](https://www.flaticon.com/free-icon/github-logo_25231)\n- Superb icon generation: [`folderify`](https://github.com/lgarron/folderify)\n- Brilliant icon application automation: [`fileicon`](https://github.com/mklement0/fileicon)\n- Fabulous macOS package manager: [`brew`](https://brew.sh/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fothyn%2Fgithub-folder-icon-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fothyn%2Fgithub-folder-icon-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fothyn%2Fgithub-folder-icon-macos/lists"}