Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Manually changing application icon for Windows

Windows applications use a Windows only format called ICO for their file icon and taskbar icon. Since Godot 4.1, Godot can create an ICO file for you based on the icon file defined in the Windows export preset. Supported formats are PNG, WebP, and SVG. If no icon is defined in the Windows export preset, the application/config/icon project setting is used automatically instead.

This means you no longer need to follow the steps in this section to manually create an ICO file, unless you wish to have control over the icon design depending on its displayed size.

Creating a custom ICO file

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.

Este tutorial em vídeo explica como exportar um arquivo ICO com o GIMP.

Também é possível converter uma imagem PNG para um arquivo ICO amigável ao hiDPI usando este comando do ImageMagick:

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

Depending on which version of ImageMagick you installed, you might need to leave out the magick and run this command instead:

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

Aviso

Para o arquivo ICO apropriadamente substituir o ícone Godot predefinido, ele deve conter todos os tamanhos inclusos no ícone Godot predefinido: 16x16, 32x32, 48x48, 64x64, 128x128, 256x256. Caso o arquivo ICO não contenha todos os tamanhos, o ícone Godot predefinido será mantido para os que não foram substituídos.

O comando de ImageMagick acima leva isso em consideração.

Mudando o ícone da barra de tarefas

O ícone da barra de tarefas é o ícone que aparece na barra de tarefas quando seu projeto está sendo executado.

../../_images/icon_taskbar_icon.png

To change the taskbar icon, go to Project > Project Settings > Application > Config, make sure Advanced Settings are enabled to see the setting, then go to Windows Native Icon. Click on the folder icon and select your ICO file.

../../_images/icon_project_settings.webp

Esta configuração só altera o ícone do jogo exportado no Windows. Para definir o ícone para macOS, use Macos Native Icon. E para qualquer outra plataforma, use a configuração Icon.

Mudando o ícone do arquivo

O ícone do arquivo é o ícone do executável que você clica para iniciar o projeto.

../../_images/icon_file_icon.png

To do that, you will need to specify the icon when exporting. Go to Project > Export. Assuming you have already created a Windows Desktop preset, select your icon in ICO format in the Application > Icon field.

../../_images/icon_export_settings.webp

Testando o resultado

Agora você pode exportar o projeto. Se funcionou corretamente, você deve ver isto:

../../_images/icon_result.png

Nota

If your icon isn't showing up properly try clearing the icon cache. To do so, open the Run dialog and enter ie4uinit.exe -ClearIconCache or ie4uinit.exe -show.