diff --git a/docs/tutorial/unity-launcher.md b/docs/tutorial/unity-launcher.md new file mode 100644 index 000000000000..dd0148f12d82 --- /dev/null +++ b/docs/tutorial/unity-launcher.md @@ -0,0 +1,38 @@ +# Unity Launcher Shortcuts + +In Unity, you can add custom entries to its launcher via modifying the +`.desktop` file, see [Adding Shortcuts to a Launcher][unity-launcher]. + +__Launcher shortcuts of Audacious:__ + +![audacious][audacious-launcher] + +Generally speaking, shortcuts are added by providing a `Name` and `Exec` +property for each entry in the shortcuts menu. Unity will execute the +`Exec` field once clicked by the user. The format is as follows: + +```text +Actions=PlayPause;Next;Previous + +[Desktop Action PlayPause] +Name=Play-Pause +Exec=audacious -t +OnlyShowIn=Unity; + +[Desktop Action Next] +Name=Next +Exec=audacious -f +OnlyShowIn=Unity; + +[Desktop Action Previous] +Name=Previous +Exec=audacious -r +OnlyShowIn=Unity; +``` + +Unity's preferred way of telling your application what to do is to use +parameters. You can find these in your app in the global variable +`process.argv`. + +[unity-launcher]: https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles#Adding_shortcuts_to_a_launcher +[audacious-launcher]: https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles?action=AttachFile&do=get&target=shortcuts.png