❤️ First round of feedback

docs/tutorial/linux-desktop-actions.md

@@ -0,0 +1,41 @@
+# Custom Linux Desktop Launcher Actions
+
+On many Linux environments, you can add custom entries to its launcher
+by modifying the `.desktop` file. For Canonical's Unity documentation,
+see [Adding Shortcuts to a Launcher][unity-launcher]. For details on a
+more generic implementation, see the [Free Desktop Specification][spec].
+
+__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
+[spec]: https://specifications.freedesktop.org/desktop-entry-spec/1.1/ar01s11.html