Editing Desktop file format
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 9: | Line 9: | ||
These files are parsed by a number of different modules in Maemo: hildon-desktop reads them to display icons in the main application menu, and launch applications. [http://maemo.gitorious.org/fremantle-hildon-desktop/libhildonmime/ libhildonmime] reads the files to launch applications associated with a specific mime type. | These files are parsed by a number of different modules in Maemo: hildon-desktop reads them to display icons in the main application menu, and launch applications. [http://maemo.gitorious.org/fremantle-hildon-desktop/libhildonmime/ libhildonmime] reads the files to launch applications associated with a specific mime type. | ||
- | |||
- | |||
- | |||
- | |||
=== Standard keys === | === Standard keys === | ||
Line 19: | Line 15: | ||
{| class="wikitable" | {| class="wikitable" | ||
- | |||
|- | |- | ||
! Key | ! Key | ||
Line 26: | Line 21: | ||
! Required? | ! Required? | ||
|- | |- | ||
- | | | + | | Type |
| string | | string | ||
| Possible values are "Application", "Link" or "Directory". Only "Application" and "Directory" are parsed on Maemo. | | Possible values are "Application", "Link" or "Directory". Only "Application" and "Directory" are parsed on Maemo. | ||
| Y | | Y | ||
|- | |- | ||
- | | | + | | Name |
| string | | string | ||
| The name of the Desktop Entry group - should be unique on the system | | The name of the Desktop Entry group - should be unique on the system | ||
| Y | | Y | ||
|- | |- | ||
- | | | + | | Icon |
| string | | string | ||
| Icon to display in file manager, menus, etc. If the name is an absolute path, the given file will be used. If the name is not an absolute path, the algorithm described in the [http://freedesktop.org/wiki/Standards/icon-theme-spec Icon Theme Specification] will be used to locate the icon. | | Icon to display in file manager, menus, etc. If the name is an absolute path, the given file will be used. If the name is not an absolute path, the algorithm described in the [http://freedesktop.org/wiki/Standards/icon-theme-spec Icon Theme Specification] will be used to locate the icon. | ||
| N | | N | ||
|- | |- | ||
- | | | + | | Comment |
| string | | string | ||
| Tooltip for the icon. Unused in touch interface. | | Tooltip for the icon. Unused in touch interface. | ||
| N | | N | ||
|- | |- | ||
- | | | + | | NoDisplay |
| boolean | | boolean | ||
| If this is set to <code>true</code> the icon will not be shown in the menu. This is useful for applications which are associated with a mime type, but are not intended for standalone use. | | If this is set to <code>true</code> the icon will not be shown in the menu. This is useful for applications which are associated with a mime type, but are not intended for standalone use. | ||
| N | | N | ||
|- | |- | ||
- | | | + | | Exec |
| string | | string | ||
| The absolute path to the executable to be run when the desktop entry is selected. | | The absolute path to the executable to be run when the desktop entry is selected. | ||
| N | | N | ||
|- | |- | ||
- | | | + | | Categories |
| string | | string | ||
| This field is not used by hildon-desktop, but is used by 3rd party applications such as Catorise | | This field is not used by hildon-desktop, but is used by 3rd party applications such as Catorise | ||
| N | | N | ||
|- | |- | ||
- | | | + | | MimeType |
| string | | string | ||
| Parsed by libhildonmime, this field relates the mime type of a file to the applications which can be used to open it. | | Parsed by libhildonmime, this field relates the mime type of a file to the applications which can be used to open it. | ||
Line 67: | Line 62: | ||
|} | |} | ||
- | The frequently found key " | + | The frequently found key "Version=" seems is unused in Maemo for time of this writing. Anyway according to http://standards.freedesktop.org/desktop-entry-spec/1.0/ar01s05.html it MUST NOT hold the version of the executable, rather it defines the format and version of the .desktop file itself *). In expression: |
Version=1.0 is the only valid version key for .desktop files (of v1.0) | Version=1.0 is the only valid version key for .desktop files (of v1.0) | ||
*)>>Version of the Desktop Entry Specification that the desktop entry conforms with. Entries that conform to this version of the specification should use 1.0. Note that the version field is not required to be present. | *)>>Version of the Desktop Entry Specification that the desktop entry conforms with. Entries that conform to this version of the specification should use 1.0. Note that the version field is not required to be present. | ||
Line 76: | Line 71: | ||
{| class="wikitable" | {| class="wikitable" | ||
- | |||
|- | |- | ||
! Key | ! Key | ||
Line 82: | Line 76: | ||
! Meaning | ! Meaning | ||
|- | |- | ||
- | | | + | | X-Text-Domain |
| string | | string | ||
| The L10n domain from which the application name is translated (with dgettext) | | The L10n domain from which the application name is translated (with dgettext) | ||
|- | |- | ||
- | | | + | | X-Osso-Service |
| string | | string | ||
- | | DBus service name - if specified hildon desktop will try to call the | + | | DBus service name - if specified hildon desktop will try to call the top_application method on this service rather than execute what is listed in the Exec field). |
|- | |- | ||
- | | | + | | X-App-Loading-Image |
- | | | + | | |
- | | | + | | |
|- | |- | ||
- | | | + | | X-Maemo-Prestarted |
| boolean | | boolean | ||
- | | If true, the application will be started automatically at boot time | + | | If true, the application will be started automatically at boot time |
- | + | ||
|- | |- | ||
- | | | + | | X-Maemo-Wm-Class |
| | | | ||
| | | | ||
|- | |- | ||
- | | | + | | X-Maemo-Prestarted-Priority |
- | | | + | | nuber |
| Priority for the application launch - lower means application is launched sooner | | Priority for the application launch - lower means application is launched sooner | ||
|- | |- | ||
- | | | + | | X-Maemo-Switcher-Icon |
| | | | ||
| | | | ||
|- | |- | ||
- | | | + | | X-Maemo-Ignore-Lowmem |
| boolean | | boolean | ||
| Ignore the low memory status when this application is launched. If this is absent, or set to false, an application will not be launched if there is insufficient memory available. | | Ignore the low memory status when this application is launched. If this is absent, or set to false, an application will not be launched if there is insufficient memory available. | ||
|- | |- | ||
- | | | + | | X-Maemo-Prestarted-Ignore-Load |
| boolean | | boolean | ||
| If true, prestart the app as soon as possible without regards to load or memory limits | | If true, prestart the app as soon as possible without regards to load or memory limits | ||
|- | |- | ||
- | | | + | | X-Osso-Service |
| string | | string | ||
| The name of the DBus service to call to start this application on demand | | The name of the DBus service to call to start this application on demand | ||
|- | |- | ||
- | | | + | | X-Osso-URI-Actions |
| string | | string | ||
- | | Used in [[URL Handler/API rev1|version 1 of URL handler]] to indicate URI handlers which this application can deal with | + | | Used in [[URL Handler/API rev1 | version 1 of URL handler]] to indicate URI handlers which this application can deal with |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
|} | |} | ||
- | Note that while Maemo 5 (Fremantle) does not by default read the " | + | Note that while Maemo 5 (Fremantle) does not by default read the "Categories="-entry from the desktop file, enhanced menu applications like [http://maemo.org/downloads/product/Maemo5/catorise/ Catorise] do. It is recommended that you add a Categories line to the .desktop file. |
Categories=Office; ''Office or whatever Category is suitable'' | Categories=Office; ''Office or whatever Category is suitable'' | ||
Line 142: | Line 131: | ||
=== URL handlers === | === URL handlers === | ||
- | There are a number of custom fields used in [http://maemo.gitorious.org/fremantle-hildon-desktop/libhildonmime/blobs/master/libhildonmime/hildon-uri.c hildon-uri.c] to handle [[URL Handler|custom URI groups]]. | + | There are a number of custom fields used in [http://maemo.gitorious.org/fremantle-hildon-desktop/libhildonmime/blobs/master/libhildonmime/hildon-uri.c hildon-uri.c] to handle [[URL Handler | custom URI groups]]. |
== OS 2008 - Chinook == | == OS 2008 - Chinook == |
Learn more about Contributing to the wiki.