Application Icon

From Free Pascal wiki
Revision as of 12:48, 2 August 2020 by Trev (talk | contribs) (→‎Setting the Application Icon on macOS: Added syntax highlighting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Deutsch (de) English (en) español (es) 日本語 (ja) português (pt)

The application icon is usually displayed on the main window of the application, and it can be changed as per the code in Changing application Icon.

To change the icon of the executable itself, it is necessary to employ a platform-dependent technique. In Lazarus 0.9.27 support for this was added to the Project Options dialog, but it currently doesn't work for Linux because it requires calling an application to set the icon.

IDE support for the Application Icon

Just set the icon in the Project Options dialog, accessible in the Project menu.

Works for Windows and macOS.

Platform-specific techniques


1. Create a new file named "project.rc" (for example) containing:

  MAINICON ICON "editor.ico" 

2. Include in you project *.lpr file the following instruction:

  {$R project.rc} 

Work with version 0.9.24 and above.

3. In the article Windows Icon you can see the best practices for creating the icon.

Setting the Application Icon on macOS

Under macOS it is necessary to set an icon for the Application Bundle. This is done by adding a field to the Info.plist file, like this:


Where iconfile.icns is located inside

You can find instructions to create an icns file here


Under Linux application icons are located in special directories which are different on each Window Manager. The structure inside that directory, however, is standardized and described on the Icon Theme Specification.

In order to determine how an application is launched the operating system uses a text file with the extension .application. This file provides different information including a description of the application, categories and locations of the executable and the icon. The standard is described in the Desktop Entry Specification of

K Desktop Environment (KDE)

You can find the directory for application icons for use by all users and for each user using the command:

kde-config --path icon

This should print a list of colon-separated paths to stdout.


You can find the directory for application icons for use by all users and for each user using the command:

gnome-config --datadir

This should print a path to stdout, inside which is found a directory called pixmaps that attends to the Icon Theme Specification.


In LXDE, icons are located in the directory


.application files are in