{{tag>sysadmin software linux freedesktop icone lanceur bureau}}

 
====== Création d'un icône (lanceur) pour un bureau virtuel Linux ======

La plupart des environnements graphiques proposant des bureaux virtuels peuvent utiliser le format proposé par le projet freedesktop (desktop entry) pour la création de lanceur d’application disposé sur le bureau ou dans les menus.


Un exemple de création de lanceur pour l'application Freecad déployée sur l’hôte au format [[sysadmin/linux/format_appimage|AppImage]].

<code bash>
# Création d'un répertoire pour stocker les icônes
mkdir ~/.local/share/icons

# Place l’icône dans le répertoire dédié
mv /tmp/FreeCAD-logo.svg ~/.local/share/icons/
</code>

Créer un fichier d'extension .desktop dans le répertoire ''~/.local/share/applications''. Le contenu du fichier ''.desktop'' peut être relativement simple :

<file>
[Desktop Entry]

Type=Application
Version=1.0

Name=FreeCAD-0.21.2-Linux-x86_64.AppImage

Comment=DAO Freecad 0.21.2 (AppImage)

# NB : Utiliser des chemins absolus
# Executables et ses arguments
Exec=/home/yoann/Applications/FreeCAD-0.21.2-Linux-x86_64.AppImage

# Icône associé au lanceur
Icon=/home/yoann/.local/share/icons/FreeCAD-logo.svg

# Describes whether this application needs to be run in a terminal or not
Terminal=false
</file>

La documentation officielle fournit la [[https://specifications.freedesktop.org/desktop-entry-spec/1.5/recognized-keys.html|liste des attributs (keys) disponibles]].

Placer le droit d'exécution sur le fichier:

<code bash>
chmod u+x FreeCAD-0.21.2.desktop
</code>

===== Les catégories =====

L'application lancée peut être associée à une ou plusieurs catégories/sous-catégories (entrée ''Categories''). Les catégories préexistent et leur nom est sensible à la casse : [[https://specifications.freedesktop.org/menu-spec/1.0/category-registry.html|Liste exhaustive des catégories]].

===== Vérifier la syntaxe =====

<code bash>
desktop-file-validate FreeCAD-0.21.2.desktop
</code>

Invoquer **update-desktop-database** pour que les modifications apportées soient prises en compte:
<code bash>
update-desktop-database ~/.local/share/applications
</code>


===== Exécuter un fichier .desktop depuis le terminal =====

<code bash>
gtk-launch /path/to/application.desktop
</code>

===== Références =====

  * [[https://stackoverflow.com/questions/119031/how-to-set-my-applications-desktop-icon-for-linux-kde-gnome-etc|Comment créer son lanceur sous KDE ou Gnome (stackoverflow.com) ]]
  * [[https://www.freedesktop.org/wiki/| wiki du standard freedesktop (freedesktop.org) ]]
  * [[https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html|Spécifications du fichier .desktop (freedesktop.org) ]]
  * [[https://www.devdungeon.com/content/create-linux-desktop-launch-icon|Créer un icône de lanceur (devdungeon.com)]]
  * [[https://wiki.archlinux.org/title/Desktop_entries| Application entry (archlinux) ]]