Menüeinträge¶

Einen ersten Überblick kann man sich mit diesen Befehlen (jeweils mit Beispielausgabe) verschaffen:

1. Auflistung aller benutzen Ordner für Menüeinträge:

   find /usr/ ~ -name applications 

   /usr/share/ubuntu/applications
   /usr/share/gdm/greeter/applications
   /usr/share/ubuntu-wayland/applications
   /usr/share/applications
   /usr/local/share/applications
   /home/kB/.local/share/applications
   /usr/share/ubuntu/applications

   Hier werden auch einige Ordner gefunden, welche nicht zum Standard nach freedesktop.org gehören, im Beispiel die mit ubuntu und gdm im Pfad. Andererseits sind es noch nicht alle möglichen Ordner.

2. Es werden alle Verzeichnisse durchsucht, welche über die Umgebungsvariablen XDG_DATA_HOME (wenn nicht gesetzt, dann per Vorgabe ~/.local/share/) und XDG_DATA_DIRS als Suchpfad auftauchen:

   echo ${XDG_DATA_HOME:-~/.local/share/}:$XDG_DATA_DIRS 

   /home/kB/.local/share/:/usr/share/ubuntu-xorg:/usr/share/gnome:/usr/local/share/:/usr/share/

   Die beispielhafte Ausgabe stammt vom GNOME-Desktop unter Ubuntu 22.04 und kann bei anderen Desktops oder Versionen anders lauten. Die Ordner in diesem Suchpfad müssen nicht alle existieren. Es wird stets die erste gefundene passende Datei verwendet und ggf. weitere gleichnamige Dateien werden ignoriert; d.h. Systemdateien können durch benutzerspezifische Dateien übersteuert und somit ausgeblendet oder ersetzt werden.

3. Auflistung aller Desktop-Dateien für Menüeintröge:

   find ~ /usr -path */applications/*.desktop | less 

In der Praxis werden für die Anpassung des eigenen Desktops meist nur diese Ablageorte verwendet:

1. /usr/share/applications/: Dateien in diesem Ordner werden als Menüeinträge in den Desktop-Shells jedes Benutzers angezeigt. Dateien in diesem Verzeichnis müssen dem Benutzer root gehören und dürfen nur durch diesen beschreibbar^[1] sein. In der Regel handelt es sich um Dateien, welche von der Paketverwaltung installiert und gepflegt werden.

2. /usr/local/share/applications/: Wie vorstehendes Verzeichnis, jedoch sollen hier von Administrator des Systems für alle Benutzer vorgesehene Menüeinträge abgelegt werden. Dieser Ordner muss ggf. erst von root angelegt werden.

3. ~/.local/share/applications/: Dieser Ordner im persönlichen Verzeichnis des Benutzers enthält Dateien für Menüeinträge, welche spezifisch nur diesem Benutzer angezeigt werden. Das Verzeichnis existiert nach frischer Installation nicht und muss selber angelegt werden. Gleichnamige Dateien in diesem Ordner übersteuern solche im vorher genannten Ordner.

4. Desktop-Oberfläche: Einige Desktops in einigen Versionen unterstützen noch diese veraltete und der Spezifikation widersprechenden Methode. Die Funktionsweise solcher Desktop-Dateien hängt von der jeweils verwendeten Desktop-Umgebung und deren Version ab und wird daher in diesem Artikel nicht weiter behandelt, siehe: Desktop-Symbole. Der GNOME-Desktop unterstützt dieses Feature nur über spezielle Shell-Erweiterungen.

Autostarter¶

Die vorhandenen Autostarter und die möglichen Ablageorte findet man ganz analog zum Vorgehen wie für Menüeinträge beschrieben mit diesen Befehlen (jeweils mit Beispielausgabe):

• Benutzte Ordner:

  sudo find /usr /etc/ ~ -name autostart 

  /usr/share/gnome/autostart
  /usr/share/gdm/autostart
  /usr/share/gdm/greeter/autostart
  /etc/xdg/autostart
  /home/kB/.config/autostart

• Suchpfad für Autostarter:

  echo ${XDG_CONFIG_HOME:-~/.config}:$XDG_CONFIG_DIRS 

  /home/kB/.config:/etc/xdg/xdg-ubuntu-xorg:/etc/xdg

• Vorhandene Autostarter:

  sudo find /usr /etc/ ~ -path */autostart/*.desktop | less 

Menüeintrag anlegen¶

Ein manuell angelegter Menüeintrag ist insbesondere für als AppImage (bzw. ohne Paketverwaltung) installierte Programme sinnvoll. Im folgenden praktischen Beispiel wird für das Programm linphone im Untermenü „Büro“ des Desktop-Hauptmenüs (bei GNOME: „Anwendungen“) ein Eintrag mit dem Namen „Linphone“ erstellt. Einen Texteditor öffnen^[2] und folgenden Text kopieren, einfügen und für die eigenen Bedürfnisse anpassen:

[Desktop Entry]
Version = 1.5
Type =		Application
Name =		Linphone
GenericName =	Telephony client
GenericName[de]=Telefon
Comment =	A libre SIP client
Comment[de] =	Ein freies SIP-Telefon
#	Ikon liegt im Ordner ~/.icons/
Icon =		linphone-logo.png
Categories =	Office;Telephony;
MimeType =	x-scheme-handler/sip-linphone;x-scheme-handler/sip;x-scheme-handler/sips-linphone;x-scheme-handler/sips;x-scheme-handler/tel;x-scheme-handler/callto;
OnlyShowIn =	GNOME;XFCE;

Terminal =	false
Exec =		linphone %F
StartupNotify =	true

Die Datei nun im Ablageort im eigenen Verzeichnis unter einem aussagekräftigen Namen wie z.B. linphone.desktop abspeichern. Man kann alternativ auch ein systemweit gültiges Verzeichnis dafür verwenden, benötigt dann aber natürlich Root-Rechte^[3].

Der neue Eintrag erscheint als Linphone sofort mit Ikon im Menü, sofern die Desktop-Datei syntaktisch fehlerfrei ist, was man überprüfen kann.

Autostarter anlegen¶

Bei der Erstellung eines Autostarters geht man genauso vor wie bei der Erstellung eines Menüeintrags, lediglich muss man einen anderen Ablageort für die Datei wählen. Zu den Besonderheiten bei den einzelnen Desktops lese den Artikel Autostart.

Programmstarter¶

Für Programmstarter muss die Datei eine Zeile mit der Kapitelüberschrift "[Desktop Entry]" genau einmal enthalten. (Das gilt so auch bei KDE, welches früher die nun nicht mehr zulässige Variante "[KDE Desktop Entry]" benutzte.) Vor dieser Zeile dürfen nur Kommentar- und Leerzeilen stehen. In den Zeilen nach dieser Kapitelüberschrift können auch Zeilen mit Spezifikationen folgen. Jede Spezifikation beginnt mit einem Schlüsselwort aus den Tabellen 1 oder 2. Die Reihenfolge der Spezifikationen spielt keine Rolle.

Tabelle 2: Spezielle Schlüsselworte in Desktop-Dateien für Programmstarter
Schlüsselwort	Wert und Beschreibung	Erforderlich	Typ
Type = Application	Muss genau wie angegeben in der Datei stehen.	ja	string
Terminal = true Terminal = false	Angabe, ob die Applikation ein Terminal für die Kommunikation mit dem Bediener benötigt oder nicht. Applikationen, die selbst keine Fenster öffnen, benötigen den Wert true; der Desktop öffnet dann ein Fenster mit einem Terminal und verbindet dies mit den Standard-Kanälen stdin, stdout und stderr. Applikationen, welche ausschließlich über eigene Fenster oder andere Desktop-Elemente mit den Bediener kommunizieren, können den Wert false erhalten. Dies ist auch der Standardwert.	optional	boolean
Path	Ein absoluter Pfad zu einem Ordner; dieser wird zum Arbeitsverzeichnis, in welches vor dem Start des Programms gewechselt wird. (Das Schlüsselwort ist missverständlich und hat nichts mit der Umgebungsvariable PATH zu tun; es sollte besser "Pwd" lauten.)	optional	string
Exec	Ein ausführbarer Befehl, mit dem die Applikation auch in einem Terminal gestartet werden könnte. Wenn das Programm im PATH gefunden werden kann, reicht der Dateiname aus; anderenfalls ist der absolute Pfad zu verwenden. Hinter dem Programmnamen können optional Parameter für das Programm angegeben werden. Hierbei sind allerdings alle Sonderzeichen für Desktop-Dateien und alle Sonderzeichen für die Shell zu quotieren. Siehe dazu auch Startmethoden und The Exec key 🇬🇧 sowie Optionen übergeben.	optional	string
TryExec	Ein ausführbarer Befehl, der entweder über die Umgebungsvariable PATH gefunden wird oder mit absolutem Pfad anzugeben ist. Dieser Befehl soll testen, ob das mit Exec angegebene Programm ausführbar ist. Wenn diese Spezifikation fehlt, wird ersatzweise der mit Exec angegebene Befehl hierfür verwendet, was bei großen Programmen die Performance des Desktops beeinträchtigen kann.	optional	string
StartupNotify=true StartupNotify=false	Beschreibt, ob die Applikation das "Startup notification protocol" 🇬🇧 beherrscht oder nicht. Man sollte true nur dann verwenden, wenn man ganz sicher weiß, das es der Fall ist und im Zweifel false angeben oder dieses Schlüsselwort gar nicht verwenden.	nein	boolean
StartupWMClass	Eine "WM Class" oder ein "WM Name", welche von der Applikation benutzt wird. Der Desktop kann diese Information zu Optimierung der Fenster-Gruppen verwenden. Siehe: WMClass bestimmen	optional	string
DBusActivatable	s. D-Bus Activation 🇬🇧	nein	boolean
Implements	s. Interfaces 🇬🇧	nein	string-Liste
PrefersNonDefaultGPU	s. Recognized desktop entry keys 🇬🇧	nein	boolean
SingleMainWindow	s. Recognized desktop entry keys 🇬🇧	nein	boolean
Actions	Eine Liste von Namen für Aktionen im Kontextmenü (oft: Rechtsklick ) der Applikation; siehe Aktionen im Kontextmenü Siehe auch: Additional applications actions 🇬🇧. Wichtig: Für jede Aktion muss diese Desktop-Datei auch eine Kapitelüberschrift enthalten!	optional	string-Liste
MimeType	Eine Liste von MIME-Typen wie in der Datei /etc/mime.types genannt und die von der in dieser Desktop-Datei beschriebenen Applikation unterstützt werden. Dateimanager benutzen diese Information, um für zu öffnende Dateien geeignete Programme vorzuschlagen. Siehe: MIME-Typen	optional	string-Liste
Categories	Eine Liste mit standardisierten Bezeichnern 🇬🇧 für Untermenüs im Hauptmenü. Die Anwendung wird mit Namen (s. Schlüsselwort Name) und Ikon (s. Icon) in diesen Untermenüs angezeigt.	optional	string-Liste
Keywords	Liste von Stichwörtern, die z.B. von Suchfunktionen benutzt werden können. Desktop-Dateien lassen sich über die Desktop-Suche schnell finden, wenn man per Schlüsselwort Keywords geeignete Suchbegriffe speichert.	optional	localestring-Liste

Exec = ssh "spy@nsa.usa.gov"
Exec=InyokaEdit %F
Exec = bash -c "lsblk -lf /dev/sd? ; read"
Exec	=	nm-connection-editor
Exec=/opt/firefox/firefox-bin %u
Exec=/usr/lib/jvm/java-7-openjdk-amd64/bin/java -jar %f

grep mp3   /etc/mime.types 

audio/mpeg					mpga mpega mp1 mp2 mp3
audio/vnd.sealedmedia.softseal.mpeg		smp3 smp s1m

Andere Typen von Desktop-Dateien¶

Bei Desktop-Dateien gibt es noch die zulässigen Typen Directory und Link:

• Beim Typ Directory sind nur die Schlüsselworte aus Tabelle 1 zulässig. Zu den Einzelheiten lese den Artikel .directory-Dateien.

• Typ Link (Lesezeichen) sind nur die Schlüsselworte aus Tabelle 1 erlaubt, und als weiteres Schlüsselwort ist "URL" erforderlich. Auch syntaktisch richtige Lesezeichen müssen nicht funktionieren; beispielsweise behandelt GNOME so etwas nicht wie erwartet.

• Alle anderen Werte für Type sind veraltet; auch der früher bei KDE verwendete Typ MimeType.

Weitere Schlüsselworte¶

Man darf beliebige eigene Schlüsselworte erfinden und verwenden. Diese sollten mit „X-“ beginnen. Natürlich macht das nur dann Sinn, wenn die eigene Software auch selbst Desktop-Dateien auswertet.

Für den Desktop KDE gibt es zusätzlich diese speziellen Schlüsselworte:

• Dev

• FSType

• MountPoint

• ReadOnly

• UnmountIcon

Es gibt einige veraltete Schlüsselworte, die nicht mehr verwendet werden sollten: Patterns, DefaultApp, Encoding, MiniIcon, TerminalOptions, Protocols, Extensions, BinaryPattern, MapNotify, SwallowTitle, SwallowExec, SortOrder, FilePattern.

Lese die offizielle Dokumentation, insbesondere Recognized desktop entry keys 🇬🇧

Lokalisierung¶

In einer Desktop-Datei kann man alle Elemente des Typs localestring lokalisieren, damit – je nach verwendeter Systemsprache – in der Desktop-Oberfläche Name und Beschreibung in der jeweiligen Sprache erscheinen. Dafür setzt man hinter dem Namen des zu lokalisierenden Elements in Klammern den Ländercode und nach dem Gleichheitszeichen die Übersetzung. Für das Element GenericName sähe das beispielsweise folgendermaßen aus:

GenericName=Music Player
GenericName[de]=Musik Player
GenericName[fi]=Musiikkisoitin
GenericName[pl]=Odtwarzacz Muzyki
GenericName[se]=Musikspelare

Desktop-Dateien unterstützen auch abgestufte Lokalisierung nach Sprache und Region. Die Locale-Bezeichnungen haben üblicherweise das Format Sprache_Region@Variante (lang_COUNTRY@modifier). Sprache (lang) und Region (COUNTRY) werden durch zweistellige ISO-639- bzw. ISO-3166-Codes repräsentiert (z.B. de_DE für Deutsch/Deutschland oder de_AT für Deutsch/Österreich). Mit der Variante unterscheidet man noch speziellere Feinheiten; dies wird aber bei Desktop-Dateien meistens nicht nicht verwendet.

Die folgende Tabelle gibt einen Überblick, nach welcher Reihenfolge die einzelnen Lokalisierungen genutzt werden:

Dadurch ist es möglich, auch unterschiedliche Richtungen einer Sprache zu berücksichtigen, wie am folgenden Beispiel gezeigt:

GenericName=January
GenericName[de]=Januar
GenericName[de_de]=Januar
GenericName[de_at]=Jänner

Intern¶

• Desktop Übersichtsartikel

• Menüeditor – grafische Menüeditoren

  • Arronax – grafische Oberfläche zur Bearbeitung von Programmstartern

• Autostart

• Quicklists – zusätzliche Aktionen für Applikationen über das Kontextmenü

• .directory-Dateien – neues Untermenü erstellen

• Desktop-Symbole

Extern¶

• Specifications 🇬🇧 – Sammlung der für Desktop-Umgebungen relevanten Spezifikationen bei freedesktop.org, insbesondere:

  • Desktop Entry Specification 🇬🇧 – Aktuelle Version

  • Desktop Entry Specification 🇬🇧 – Frühere Versionen

  • Basic format of the file 🇬🇧 – INI-Format für Desktop-Dateien

  • Recognized desktop entry keys 🇬🇧 – Schlüsselworte in Desktop-Dateien

  • Registered Environments 🇬🇧) – Registrierte Kurzbezeichnungen für Desktops (Groß-/Kleinschreibung beachten!). (In dem angegebenen Link ist die Bezeichnung für Cinnamon falsch. Korrekt muss es heißen: X-Cinnamon)

  • Desktop Application Autostart Specification 🇬🇧 – Spezifikation für Autostarter

• Anatomy of a .desktop File 🇬🇧 – Blogbeitrag, 04/2010 (behandelt eine veraltete Version der Spezifikation)