Changing application icon for Windows

By default, the exported project’s icon will be the Godot icon. You will most likely want to change that for your project. There are two types of icons that can be changed on Windows: the file icon and the taskbar icon.

Creating an ICO file

Windows does not use formats such as png or jpg for application icons. Instead, it uses a Windows-only format called ICO. You can create your application icon in any program but you will have to convert it to an ICO file using a program such as GIMP. This video tutorial goes over how to export an ICO file with GIMP. ImageMagick command:

  1. magick convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

magick and run this command instead:

  1. convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

Warning all the sizes included in the default Godot icon: 16×16, 32×32, 48×48, 64×64, 128×128, 256×256. If the ICO file does not contain all the sizes, the default Godot icon will be kept for the sizes that weren’t overridden. The above ImageMagick command takes this into account.

Changing the taskbar icon

The taskbar icon is the icon that shows up on the taskbar when your project is running. Project → Project Settings → Application → Config → Windows Native Icon. Click on the folder icon and select your ICO file. Macos Native Icon. And for any other platform, use the Icon setting.

Changing the file icon

godoticon. Changing the file icon this way should work for executables containing an embedded PCK. Warning known issues when changing the application icon in executables that embed a PCK file. It’s recommended to avoid using rcedit for now if you choose to enable the Embed Pck option for your Windows export preset in the Export dialog. The file icon is the icon of the executable that you click on to start the project. rcedit. You can download it here. Editor → Editor Settings → Export → Windows. Click on the folder icon for the rcedit entry. Navigate to and select the rcedit executable. Note WINE to use rcedit. Project → Export. Assuming you have already created a Windows Desktop preset, select your icon in ICO format in the Application → Icon field. Note compile your own Windows export templates with the icon changed. To do so, replace platform/windows/godot.ico with your own ICO file before compiling export templates. Once this is done, you can specify your export templates as custom export templates in your project’s Windows export preset.

Testing the result

You can now export the project. If it worked correctly, you should see this: Note Run dialog and enter ie4uinit.exe -ClearIconCache or ie4uinit.exe -show.