1
1
.. _doc_changing_application_icon_for_windows :
2
2
3
- Changing application icon for Windows
3
+ Manually changing application icon for Windows
4
4
=====================================
5
5
6
- By default, the exported project's icon will be the Godot icon.
7
- You will most likely want to change that for your project. There are two types
8
- of icons that can be changed on Windows: the file icon and the taskbar icon.
6
+ Windows applications use a windows only format called ICO for their file icon and
7
+ taskbar icon. Since Godot 4.1, Godot can create an ICO file for you based on the
8
+ icon file defined in the Windows export preset. This icon file can be in PNG, WebP
9
+ or SVG format. If no icon is defined in the Windows export preset, the
10
+ :ref: `application/config/icon <class_ProjectSettings_property_application/config/icon >`
11
+ project setting is used automatically instead.
12
+
13
+ This means you no longer need to follow the steps in this section to
14
+ manually create an ICO file, unless you wish to have control over the icon
15
+ design depending on its displayed size.
9
16
10
17
Creating a custom ICO file
11
18
--------------------------
12
19
13
- .. note ::
14
-
15
- Since Godot 4.1, Godot can create an ICO file for you based on the icon file
16
- defined in the Windows export preset. This icon file can be in PNG, WebP or
17
- SVG format. If no icon is defined in the Windows export preset, the
18
- :ref: `application/config/icon <class_ProjectSettings_property_application/config/icon >`
19
- project setting is used automatically instead.
20
-
21
- This means you no longer need to follow the steps in this section to
22
- manually create an ICO file, unless you wish to have control over the icon
23
- design depending on its displayed size. Note that even if Godot creates the
24
- ICO file for you, you still need to
25
- :ref: `set up rcedit <doc_changing_application_icon_for_windows_changing_the_file_icon >`
26
- so that the file icon actually changes.
27
-
28
- Windows does not use formats such as PNG or JPEG for application icons. Instead,
29
- it uses a Windows-only format called ICO. You can create your application icon
30
- in any program but you will have to convert it to an ICO file using a program such
31
- as GIMP.
20
+ You can create your application icon in any program but you will have to convert it
21
+ to an ICO file using a program such as GIMP.
32
22
33
23
`This video tutorial <https://www.youtube.com/watch?v=uqV3UfM-n5Y >`_ goes over how to
34
24
export an ICO file with GIMP.
@@ -79,37 +69,11 @@ use the ``Icon`` setting.
79
69
Changing the file icon
80
70
----------------------
81
71
82
- In Godot 3.5 and later, you can change the file icon without
83
- external tools using `godoticon <https://github.com/pkowal1982/godoticon >`__.
84
- Changing the file icon this way should work for executables containing
85
- an embedded PCK.
86
-
87
72
The file icon is the icon of the executable that you click on to start
88
73
the project.
89
74
90
75
.. image :: img/icon_file_icon.png
91
76
92
- Before selecting it in the export options, you will need to install
93
- an extra tool called **rcedit **.
94
- You can download it `here <https://github.com/electron/rcedit/releases >`_.
95
-
96
- After downloading, you need to tell Godot the path to the rcedit executable
97
- on your computer.
98
- Go to **Editor > Editor Settings > Export > Windows **.
99
- Click on the folder icon for the **rcedit ** entry.
100
- Navigate to and select the rcedit executable.
101
-
102
- .. note ::
103
-
104
- Linux and macOS users will also need to install
105
- `WINE <https://www.winehq.org/ >`_ to use rcedit.
106
-
107
- On macOS, make sure to use a 64-bit version of both WINE and rcedit since
108
- 32-bit applications aren't supported anymore.
109
-
110
- .. image :: img/icon_rcedit.webp
111
-
112
- You should now have everything in place to change the file icon.
113
77
To do that, you will need to specify the icon when exporting.
114
78
Go to **Project > Export **. Assuming you have already created
115
79
a Windows Desktop preset, select your icon in ICO format in
@@ -123,21 +87,10 @@ the **Application > Icon** field.
123
87
``1.2.0.0 `` is valid but ``1.2.0 `` is not.
124
88
125
89
If you provide invalid metadata in the export preset, the application icon
126
- won't change as rcedit will fail to change the executable's metadata .
90
+ won't change.
127
91
128
92
.. image :: img/icon_export_settings.webp
129
93
130
- .. note ::
131
-
132
- If rcedit fails to change the icon, you can instead
133
- :ref: `compile your own Windows export templates <doc_compiling_for_windows >`
134
- with the icon changed. To do so, replace
135
- `platform/windows/godot.ico <https://github.com/godotengine/godot/blob/master/platform/windows/godot.ico >`__
136
- with your own ICO file *before * compiling export templates.
137
-
138
- Once this is done, you can specify your export templates as custom export
139
- templates in your project's Windows export preset.
140
-
141
94
Testing the result
142
95
------------------
143
96
@@ -147,6 +100,6 @@ You can now export the project. If it worked correctly, you should see this:
147
100
148
101
.. note ::
149
102
150
- If your icon isn't showing up properly, on Windows 10, try clearing the icon
103
+ If your icon isn't showing up properly try clearing the icon
151
104
cache. To do so, open the **Run ** dialog and enter ``ie4uinit.exe
152
105
-ClearIconCache `` or ``ie4uinit.exe -show ``.
0 commit comments