Create a launcher - gd-99/symbiogd GitHub Wiki

A launcher is the icon you click on to start an app.

Basic usage

To create a launcher, create a file in the directory /usr/share/applications named myapp.xml (replace myapp by the name of your app).

Here is a template :

<?xml version="1.0" encoding="UTF-8"?>
<shortcut>
        <attribute name="title" value="My super app"/>
        <attribute name="description" value="Launch my super app !"/>
        <attribute name="command" value="mysuperapp"/>
        <attribute name="icon" value="applications/mysuperapp"/>
        <attribute name="category" value="accessories"/>
</shortcut>
  • title : your app's title
  • description : your app's small description
  • command : your app's command. For example, it will execute the Javascript file /usr/bin/mysuperapp.js.
  • icon : your app's icon. Icons are stored in /usr/share/icons/applications. For example, an icon with a size of 48 pixels is stored in the file /usr/share/icons/applications/48/mysuperapp.png
  • category : the app's category. Categories are listed in /usr/share/categories.

Open types

You can add the attribute openMimeTypes to specify a comma-separated list of MIME types supported by your app. For example, if your app can open plain text files and PNG images, set it to text/plain,image/png. If your app supports all text files, you can use the wildcard : text/*.

        <attribute name="openMimeTypes" value="text/*"/>

Translating

You can specify the title of your app and its description in other languages by adding the lang attribute :

        <attribute name="title" value="gedit text editor"/>
        <attribute name="title" lang="fr_FR" value="Éditeur de texte gedit"/>
        <attribute name="title" lang="es_ES" value="Editor de texto gedit"/>
        <attribute name="description" value="Edit plain text files"/>
        <attribute name="description" lang="fr_FR" value="Éditer des fichiers texte"/>
        <attribute name="description" lang="es_ES" value="Editar ficheros de texto"/>
⚠️ **GitHub.com Fallback** ⚠️