Desktop Launcher Actions (Linux)

Overview

On many Linux environments, you can add custom entries to the system launcher by modifying the .desktop file. For Canonical’s Unity documentation, see Adding Shortcuts to a Launcher. For details on a more generic implementation, see the freedesktop.org Specification.

audacious

NOTE: The screenshot above is an example of launcher shortcuts in Audacious audio player

To create a shortcut, you need to provide Name and Exec properties for the entry you want to add to the shortcut menu. Unity will execute the command defined in the Exec field after the user clicked the shortcut menu item. An example of the .desktop file may look as follows:

  1. Actions=PlayPause;Next;Previous
  3. [Desktop Action PlayPause]
  4. Name=Play-Pause
  5. Exec=audacious -t
  6. OnlyShowIn=Unity;
  8. [Desktop Action Next]
  9. Name=Next
  10. Exec=audacious -f
  11. OnlyShowIn=Unity;
  13. [Desktop Action Previous]
  14. Name=Previous
  15. Exec=audacious -r
  16. OnlyShowIn=Unity;

The preferred way for Unity to instruct your application on what to do is using parameters. You can find them in your application in the global variable process.argv.