Desktop file format
(→Fremantle) |
|||
| Line 1: | Line 1: | ||
= Fremantle = | = Fremantle = | ||
| + | .desktop files are read from directory: | ||
| + | /usr/share/applications/hildon/ | ||
| + | |||
| + | Example .desktop file for opening <code>top</code> in terminal: | ||
[Desktop Entry] | [Desktop Entry] | ||
Encoding=UTF-8 | Encoding=UTF-8 | ||
Version=0.1 | Version=0.1 | ||
Type=Application | Type=Application | ||
| - | Terminal=true | + | Terminal=true ''true = opens xterm window where the application is run'' |
| - | Name=topx | + | Name=topx ''the name that appears to menu'' |
| - | Exec=/usr/bin/osso-xterm top | + | Exec=/usr/bin/osso-xterm top ''the command that is executed when icon is clicked'' |
| - | Icon= | + | Icon= ''Icon for shortcut'' |
#X-Window-Icon=timerwidget | #X-Window-Icon=timerwidget | ||
X-Window-Icon= | X-Window-Icon= | ||
| - | X-HildonDesk-ShowInToolbar=true | + | X-HildonDesk-ShowInToolbar=true ''Show app in toolbar'' |
X-Osso-Type=application/x-executable | X-Osso-Type=application/x-executable | ||
Revision as of 09:15, 13 December 2009
Fremantle
.desktop files are read from directory:
/usr/share/applications/hildon/
Example .desktop file for opening top in terminal:
[Desktop Entry] Encoding=UTF-8 Version=0.1 Type=Application Terminal=true true = opens xterm window where the application is run Name=topx the name that appears to menu Exec=/usr/bin/osso-xterm top the command that is executed when icon is clicked Icon= Icon for shortcut #X-Window-Icon=timerwidget X-Window-Icon= X-HildonDesk-ShowInToolbar=true Show app in toolbar X-Osso-Type=application/x-executable
Chinook
Format of Maemo .desktop files
Below are the fields supported in hildon-desktop:
- Type
- Should be application
- Icon
- Name
- Categories
- not used on maemo, but used in Ubuntu mobile
- Comment
- now unused, was used as second line of text in the startup menu in Bora
- Exec
- NoDisplay
- set to true to hide the entry in the menu
- StartupNotify
- set to false to disable the startup notification banner
- StartupWMClass
- used to override the expected window class name, default to the binary name
Some Maemo-specific extensions:
- X-Text-Domain
- set the L10n domain from which the application name is translated (with dgettext)
- X-Osso-Service
- a 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).
(Credits to Johan Billen)
BTW: If your application needs the browser to do special URL handling, the desktop file needs to be extended accordingly.