You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+34-3Lines changed: 34 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,8 @@ What do we have here...
19
19
20
20
## 👇 Downloading & using the icon(s)
21
21
22
+
### 🐌 The manual way
23
+
22
24
The 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:
23
25
24
26
<palign="middle">
@@ -31,11 +33,39 @@ To apply the icon, right click on the directory that you wish to update the icon
Ta-da! 🎉 You're all set, the icon should now be looking glorious.
37
+
38
+
### 🚀 The fun way
39
+
40
+
There's a brilliant tool called [`fileicon`](https://github.com/mklement0/fileicon) in which can programmatically set the icons of files and folders in macOS.
41
+
42
+
To install it via [`brew`](https://brew.sh/):
43
+
44
+
```sh
45
+
brew install fileicon
46
+
```
47
+
48
+
Then, if we assume that the directory we want to set the icon for is `~/git` and the downloaded icon resides in `~/Downloads/icon.icns`:
49
+
50
+
```sh
51
+
# Assign the custom downloaded GitHub icon to ~/git
52
+
fileicon set~/git ~/Downloads/icon.icns
53
+
```
54
+
55
+
Ta-da! 🎉 You're all set, the icon should now be looking glorious.
56
+
57
+
To restore the icon to its original state:
58
+
59
+
```sh
60
+
# Remove the custom downloaded GitHub icon from ~/git
61
+
fileicon rm ~/git
62
+
```
63
+
64
+
More examples can be found under the [Examples heading in the `fileicon` README](https://github.com/mklement0/fileicon#examples).
35
65
36
66
## 🧰 Installing dependencies
37
67
38
-
I 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.
68
+
I 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.
39
69
40
70
Make 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:
41
71
@@ -94,5 +124,6 @@ Although this step is run prior to generating new icons anyway.
94
124
## 🎂 Sources
95
125
96
126
- Amazing GitHub icon: [Dave Gandy on flaticon](https://www.flaticon.com/free-icon/github-logo_25231)
0 commit comments