Différences

Ci-dessous, les différences entre deux révisions de la page.

--- raccourci-lanceur [Le 18/06/2021, 14:12]
marcusbaslerus [Création d'un lanceur]
+++ raccourci-lanceur [Le 01/08/2025, 16:24] (Version actuelle)
krodelabestiole [Modification d'un lanceur existant]
@@ Ligne 14: / Ligne 14: @@
 ===== Gestion des lanceurs =====
 Il est déjà possible de [[:tutoriel/comment_lancer_application|lancer des applications depuis votre environnement]], les opérations possibles diffèrent en fonction de votre [[:variante]] mais restent globalement similaires :
 <note help>Vous êtes utilisateur d'Unity ? [[:unity_launcher|Cette page]] vous est dédiée pour plus de détails.</note>
@@ Ligne 66: / Ligne 66: @@
 Pour construire les menus, les environnements prennent en comptent tous les fichiers ''.desktop'' qu'on trouve :
-  * soit dans ''/usr/share/applications/''
+  * dans ''/usr/share/applications/'' pour les applications accessibles à tous les utilisateurs
-  * soit dans ''~/.local/share/applications/''
+  * dans ''~/.local/share/applications/'' pour les applications seulement accessibles à l'utilisateur courant
+C'est là qu'on trouve les lanceurs des applications installées en **[[:deb]]** (via [[:dpkg]] ou [[:APT]]).
+En plus de cela pour les applications installées en **[[:snap]]** les lanceurs se trouvent :
+  * dans ''/var/lib/snapd/desktop/applications''
+et pour les applications installées en **[[:flatpak]]** :
+  * dans ''/var/lib/flatpak/exports/share/applications'' pour les applications accessibles à tous les utilisateurs
+  * aussi dans ''~/.local/share/applications'' pour les applications seulement accessibles à l'utilisateur courant.
 La plupart des gestionnaires de fichiers présentent les fichiers des lanceurs sous la forme de leur icône, avec leur nom traduit, et lancent l'application quand on clique dessus. C'est pratique quand on veut s'en servir comme de raccourcis sur le bureau, mais c'est assez gênant quand on veut les éditer, voire simplement les renommer.
@@ Ligne 77: / Ligne 85: @@
 </note>
 <note warning>Si vous voulez modifier un lanceur présent dans ''/usr/share/applications/'' (c'est le cas pour la plupart des applications), il ne faut JAMAIS modifier directement le lanceur original : les modifications devraient en effet se faire en tant que [[:sudo|super-utilisateur]], ce qui est en soi risqué, et les modifications seraient effacées à la moindre mise à jour !
 Il est conseillé de **copier le lanceur original** dans le dossier ''~/.local/share/applications/'', et de **modifier la copie**.</note>
+Pour vérifier la syntaxe du fichier ''.desktop'' modifié ou créé, utilisez l'utilitaire ''desktop-file-validate''.
 ==== Modification d'un lanceur existant ====
-Dans ce qui suit, lorsque vous précisez un chemin, quel qu'il soit, au sein d'un lanceur, il est conseillé que ce soit le chemin absolu (c'est-à-dire depuis la racine, et pas depuis votre dossier personnel ''~'').
+Dans ce qui suit, lorsque vous précisez un [[:chemins|chemin]], quel qu'il soit, au sein d'un lanceur, il est conseillé que ce soit le [[:chemins#chemin absolu]] complet (c'est-à-dire depuis la racine, et pas depuis votre dossier personnel ''~'', ni le seul nom de l'exécutable).
 === Avec MenuLibre ===
@@ Ligne 93: / Ligne 103: @@
 (En cas de souci avec [[:MenuLibre]], des alternatives comme [[:Arronax]] ou [[:Alacarte]] existent.)
-Sur //LXDE / Lubuntu//, on utilisera //LXDE Shortcut//, en lançant la commande (en tapant Alt+F2 ou depuis un terminal) :
+Sur //LXDE// / //Lubuntu//, on utilisera **LXDE Shortcut**, en lançant la commande (en tapant ''Alt''+''F2'' ou depuis un [[:terminal]]) :
-''lxshortcut -o  ~/Desktop/my_shorcut.desktop''
+  lxshortcut -o  ~/Desktop/my_shorcut.desktop
-=== Avec Nautilus ===
+=== Avec GNOME Fichiers ===
-En faisant //clic-droit -> Propriétés// sur un lanceur, on accède à quelques propriétés de base du lanceur :
+En faisant //clic-droit// -> //Propriétés// sur un lanceur, on accède à quelques propriétés de base du lanceur :
 {{ :raccourci-lanceur:exemple_proprietes_nautilus_lanceur.png?nolink&400|Le lanceur d'Abiword}}
-  * __Nom :__ le nom du programme tel qu'il apparaîtra là où sera le lanceur, ce champ est à remplir à votre convenance.
+  * **Nom** : le nom du programme tel qu'il apparaîtra là où sera le lanceur, ce champ est à remplir à votre convenance.
-  * __Description :__ le nom générique de l'application ("Navigateur Web" ou "Jeu de plateforme" par exemple). Ce champ peut être vide.
+  * **Description** : le nom générique de l'application ("Navigateur Web" ou "Jeu de plateforme" par exemple). Ce champ peut être vide.
-  * __Commande :__ la commande qui sera lancée lors d'un clic sur le lanceur.
+  * **Commande** : la commande qui sera lancée lors d'un clic sur le lanceur.
-  * __Commentaire :__ Commentaire à propos du programme, qui sur la plupart des environnements apparaîtra lorsque vous laisserez votre curseur au-dessus du lanceur. Ce champ peut être vide.
+  * **Commentaire** : commentaire à propos du programme, qui sur la plupart des environnements apparaîtra lorsque vous laisserez votre curseur au-dessus du lanceur. Ce champ peut être vide.
-  * __Icône :__ En cliquant sur l'icône, on peut choisir une nouvelle image qui fera office d'icône. (Si vous les cherchez, vos thèmes d'icônes existants sont dans ''/usr/share/icons'' ou ''~/.local/share/icons/'' ;-) )
+  * **Icône** : En cliquant sur l'icône, on peut choisir une nouvelle image qui fera office d'icône. (Si vous les cherchez, vos thèmes d'icônes existants sont dans ''/usr/share/icons'' ou ''~/.local/share/icons/'' ;-) )
-<note help>Évidemment, vous ne pourrez modifier les valeurs que si vous avez les droits sur le fichier : si vous voulez modifier un lanceur qui se trouve dans ''/usr/share/applications'', il vous faudra le copier dans ''~/.local/share/applications/'' avant tout.</note>
+<note help>Évidemment, vous ne pourrez modifier les valeurs que si vous avez les [[:droits]] sur le fichier : si vous voulez modifier un lanceur qui se trouve dans ''/usr/share/applications'', il vous faudra le copier dans ''~/.local/share/applications/'' avant tout.</note>
 ~CB~
@@ Ligne 114: / Ligne 124: @@
 === Avec un éditeur de texte ===
-En faisant //clic droit -> Ouvrir avec une autre application// sur le lanceur, vous pourrez choisir de l'éditer avec un éditeur de texte.
+En faisant un clic droit -> //Ouvrir avec une autre application// sur le lanceur, vous pourrez choisir de l'éditer avec un éditeur de texte.
 Cela vous donne plus de possibilités, mais il faut savoir éditer précisément le fichier en respectant sa syntaxe, sinon il ne fonctionnera plus.
@@ Ligne 120: / Ligne 130: @@
 Le contenu devrait ressembler à ceci :
-<note important>Aucun espace de part et d'autre du symbole "=".
+<note important>Aucun espace de part et d'autre du symbole ''=''.
-Les phrases précédés d'un # sont des commentaires, pas pris en compte lors de l'exécution du fichier.</note>
+Les phrases précédés d'un ''#'' sont des commentaires, qui ne sont pas pris en compte par le système.</note>
 <file desktop>[Desktop Entry]
@@ Ligne 130: / Ligne 140: @@
 Comment=commentaire/description du programme
 Icon=icône du programme #il peut s'agir d'un chemin, ou alors du nom d'une icône contenue dans votre thème d'icônes
-Exec=commande qui permettrait d'ouvrir le programme par le terminal
+Exec=chemin complet de la commande qui permettrait d'ouvrir le programme par le terminal
 Terminal=false  #ouvrir ou non un terminal lors de l'exécution du programme (false ou true)
 StartupNotify=false  #notification de démarrage ou non (false ou true)
 Categories=catégories du programme  #Exemple: Categories=Application;Game;ArcadeGame;</file>
-<note>Les champs ''Keywords'' et ''Categories''  contiennent des listes de termes, avec un point-virgule après __chaque__ terme.</note>
+<note>Les champs ''Keywords'' et ''Categories'' contiennent des listes de termes, avec un point-virgule '';'' après //chaque// terme.</note>
 Souvent, les champs sont aussi disponibles en versions traduites :
@@ Ligne 142: / Ligne 152: @@
 #etc.</file>
-Tous les champs possibles et leurs descriptions sont décrits [[https://standards.freedesktop.org/desktop-entry-spec/latest/ar01s06.html|ici]].
+Tous les champs possibles et leurs valeurs sont décrits [[https://standards.freedesktop.org/desktop-entry-spec/latest/ar01s06.html|ici]].
-=== Champ "Type" ===
+=== Type ===
-Le champ //Type// : détermine quel est le type auquel la commande sera associée :
+Le champ ''Type'' détermine quel est le type auquel la commande sera associée :
-  * << Application >>
+  * ''Application''
-  * << Link >>
+  * ''Link''
-  * << Directory >>
+  * ''Directory''
-Les types "Link" et "Directory" sont peu utilisés, car "Directory" ne sert à rien du point de vue de l'utilisateur, et il est généralement plus simple de faire un lien vers le fichier ou le dossier en question, plutôt qu'un lanceur. Si vous voulez un fichier ou un dossier parmi vos applications dans votre menu, ou un lien avec une icône spéciale par exemple, ça peut cependant être utile.
+Les types ''Link'' et ''Directory'' servent à faciliter l'accès respectivement à un fichier ou à un répertoire.\\ -- À utiliser cependant avec modération : les lanceurs sont censés concerner principalement des applications, et sont la seule manière simple d'y accéder. Pour les raccourcis de ce type mieux vaut généralement utiliser les fonctionnalité du [[:gestionnaire de fichiers]], telles que les [[:nautilus#les_signets_dossiers_favoris|signets]] de [[:nautilus|GNOME Fichiers]].
 == Link ==
@@ Ligne 157: / Ligne 167: @@
 Ceci est utilisé pour créer un lien vers un fichier ou un dossier, qui s'ouvrira avec le logiciel par défaut pour ce type de fichier.
-Par exemple, si vous souhaitez créer un lanceur qui permet d'ouvrir le fichier **montexte.txt** qui se trouve dans votre dossier personnel avec votre éditeur de texte par défaut, on n'utilise pas le champ "Exec=" dans le fichier, mais le champ "URL=", où on renseignera la valeur suivante
+Par exemple, si vous souhaitez créer un lanceur qui permet d'ouvrir le fichier ''montexte.txt'' qui se trouve dans votre dossier personnel avec votre éditeur de texte par défaut, on n'utilise pas le champ ''Exec='' dans le fichier, mais le champ ''URL='', où on renseignera la valeur suivante
 <code>file:///home/<votre_nom_d'utilisateur>/montexte.txt</code>
-Avec des logiciels graphiques dédiés (utilitaire de création de lanceurs de MATE), il semble également possible de cliquer sur le bouton //Parcourir// pour sélectionner le fichier à ouvrir.
+Avec des logiciels graphiques dédiés (utilitaire de création de lanceurs de MATE), il est également possible de cliquer sur le bouton //Parcourir// pour sélectionner le fichier à ouvrir.
-Pour les emplacements "spéciaux", comme les fichiers récents avec [[:Nautilus]] par exemple, il est préférable de faire un lanceur de type "Application" et lui donner une commande telle que <file>Exec=nautilus recent://</file>
+Pour les emplacements "spéciaux", comme les fichiers récents avec [[:nautilus|GNOME Fichiers]] par exemple, il est préférable de faire un lanceur de type ''Application'' et lui donner une commande telle que <file>Exec=nautilus recent://</file>
 == Directory ==
@@ Ligne 168: / Ligne 178: @@
 Ceci est utilisé pour organiser les menus, le fichier se termine alors en ''.directory'' et n'est pas lançable.
-=== Champ "Exec" (commande à exécuter) ===
+=== Exec ===
 == Cas général ==
-Le champ //Commande// ("Exec=") contiendra la commande qui lance l'application. Ce sera souvent le nom de l'application dont vous cherchez à créer le lanceur, écrite en minuscules :
+Le champ //Commande// (''Exec='') contiendra la commande à exécuter lors du déclenchement du lanceur (par un clic ou double clic principalement). Il s'agit donc généralement de la commande qui lance l'application, qui est le nom du fichier binaire (exécutable) de l'application. Ce nom reprend souvent le nom de l'application dont vous cherchez à créer le lanceur, écrite en minuscules :
 Par exemple, pour un lanceur démarrant [[:Firefox]] :
 <code>firefox</code>
-Alternativement, on peut indiquer le chemin complet. Il faudra saisir dans un [[:terminal]] la [[:commande_shell|commande]] suivante:
+Cependant, pour être sûr que le lanceur fonctionne partout il faut indiquer le [[:chemins|chemin complet]] de l'exécutable. Pour le connaître on peut saisir dans un [[:terminal]] la [[:commande_shell|commande]] suivante:
 <code>which firefox</code>
-pour connaître ce chemin complet.
 Veillez à respecter la casse ((différence minuscule/majuscule)) lorsque vous remplissez la commande.
@@ Ligne 191: / Ligne 201: @@
 == Application installée hors dépôts  ====
-Si vous souhaitez créer un lanceur pour une application installée autrement que depuis les [[:dépôts]], par exemple mise en place par vos soins dans votre **Dossier Personnel** ou dans le dossier **/opt/**, il vous faudra au choix :
+Si vous souhaitez créer un lanceur pour une application installée autrement que depuis les [[:dépôts]], par exemple mise en place par vos soins dans votre **Dossier Personnel** ou dans le répertoire ''/opt/'', il vous faudra au choix :
   * soit saisir le chemin complet vers votre exécutable. Si vous ne savez pas comment renseigner ce chemin, vous pouvez vous aider du bouton **Parcourir**.
   * créer un lien symbolique vers un des répertoires de la variable PATH en saisissant dans un [[:terminal]] la [[:commande_shell|commande]] suivante: <code>sudo ln -s /chemin/de/l'exécutable /usr/bin/nom_du_programme</code>
@@ Ligne 199: / Ligne 209: @@
 Si vous souhaitez créer un lanceur pour un logiciel et un fichier particulier, après avoir choisi le //Type// << Application >> , rajoutez l'emplacement du fichier après la commande.
-Par exemple, pour utiliser [[:totem]] pour lire le fichier **exemple.avi** qui se trouve dans un dossier **film** de l'utilisateur, il s'agira d'indiquer la commande suivante :
+Par exemple, pour utiliser [[:totem]] pour lire le fichier ''exemple.avi'' qui se trouve dans un dossier ''film'' de l'utilisateur, il s'agira d'indiquer la commande suivante :
 <code>totem /home/<votre_nom_d'utilisateur>/Vidéos/exemple.avi</code>
@@ Ligne 209: / Ligne 219: @@
 <code>env WINEPREFIX="$HOME/.wine" wine "C:\Program Files\Dofus\UpLauncher.exe"</code>
-Autre exemple, si je ne veux pas que le thème "Vertex Dark" que j'utilise ne rende illisible les formulaires sur le web, je peux lancer Firefox avec un thème clair, différent du reste du système :
+Autre exemple, si on ne veut pas que le thème "Vertex Dark" qu'on utilise ne rende illisible les formulaires sur le web, on peut lancer Firefox avec un thème clair, différent du reste du système :
 <code>env GTK_THEME="Vertex:light" firefox</code>
@@ Ligne 219: / Ligne 229: @@
 <code>sh -c /home/<votre_nom_d'utilisateur>/Scripts/test.sh</code>
-<note help>Si malgré les bons [[:droits]] attribués à votre script, celui-ci ne semble pas s'exécuter depuis le lanceur, vérifiez d'avoir bien choisi le //Type// "Application".
+<note help>Si malgré les bons [[:droits]] attribués à votre script, celui-ci ne semble pas s'exécuter depuis le lanceur, vérifiez d'avoir bien choisi le //Type// ''Application''.
 </note>
@@ Ligne 226: / Ligne 236: @@
 La ligne de commande peut contenir des codes spéciaux. Ils seront remplacés avec la valeur correspondante en cas de besoin :
-  * **%f** Un nom de fichier unique, même si plusieurs fichiers sont sélectionnés. Si le fichier n'est pas dans le système de fichier local (ex. disponible en HTTP ou en FTP), il sera téléchargé et %f pointera sur le fichier temporaire (à utiliser pour les applications ne comprenant pas la syntaxe URL).
+  * ''%f'' Un nom de fichier unique, même si plusieurs fichiers sont sélectionnés. Si le fichier n'est pas dans le système de fichier local (ex. disponible en HTTP ou en [[:FTP]]), il sera téléchargé et ''%f'' pointera sur le fichier temporaire (à utiliser pour les applications ne comprenant pas la syntaxe [[:web#URL]]).
-  * **%F** Une liste de fichiers. À utiliser pour des applications qui peuvent ouvrir plusieurs fichiers à la fois.
+  * ''%F'' Une liste de fichiers. À utiliser pour des applications qui peuvent ouvrir plusieurs fichiers à la fois.
-  * **%u** Une URL unique.
+  * ''%u'' Une URL unique.
-  * **%U** Une liste d'URLs.
+  * ''%U'' Une liste d'URLs.
-Par exemple, si on fait "clic-droit/ouvrir avec" sur un fichier, et qu'on choisit une application dont le lanceur contient "%f" à la fin de sa ligne "Exec=", %f sera remplacé par le nom du fichier avant que la commande ne se lance.
+Par exemple, si on fait "clic-droit / //ouvrir avec//" sur un fichier, et qu'on choisit une application dont le lanceur contient ''%f'' à la fin de sa ligne ''Exec='', ''%f'' sera remplacé par le nom du fichier avant que la commande ne se lance.
-<note>Pour une explication plus complète voir [[http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables|la liste de variable exec]] (en) dans les définitions standards de freedesktop.org </note>
+<note>Pour une explication plus complète voir [[http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables|la liste de variable exec]] (en) dans les définitions standards de Freedesktop.org.</note>
 ==== Création d'un lanceur ====
@@ Ligne 251: / Ligne 261: @@
 ~CB~
-<note>Compatible avec l'environnement [[:GNOME3]].</note>
+<note>Compatible avec l'environnement [[:GNOME]].</note>
 Pour créer un lien vers un dossier ou fichier :
 maintenir les touches **Ctrl** et **Shift** (Majuscule) enfoncé, glisser le dossier (ou fichier) sur le bureau.
@@ Ligne 261: / Ligne 271: @@
 Pour faire un raccourci sur un tableau de bord :
   * faites un clic-droit dessus (pour //gnome-session-fallback//, voir [[:gnome-session-fallback#lanceurs_sur_le_tableau_de_bord|ici]] le raccourci clavier correspondant),
   * choisissez //Ajouter au tableau de bord -> Lanceur d'application personnalisé//
   * reportez-vous à la section « [[#Modification d'un lanceur existant]] » pour savoir quoi mettre comme valeur dans les champs présentés.
@@ Ligne 302: / Ligne 312: @@
 Une [[:nautilus_utilisation_avancee#extensions_de_nautilus|extension Nautilus]] (non-officielle, à installer avec la méthode présentée par le développeur), est aussi disponible à [[https://github.com/Maestroschan/nautilus-create-launcher|cette adresse]].
+=== Création avec un éditeur de texte ===
+Ci-dessous sont résumées les grandes étapes.
+  - Avec un éditeur de texte, **créer le fichier avec l'extension''.desktop''**  (ex. : ''une_app.desktop'') :
+    - accessible pour **tous les utilisateurs** : avec les droits root (sudo) créer le fichier dans **''/usr/share/applications/''** (ex : ''$ vim /usr/share/applications/une_app.desktop'').
+    - accessible uniquement pour **un utilisateur** : créer le fichier dans **''~/.local/share/applications/''** (ex. : ''$ vim /usr/share/applications/une_app.desktop'').
+  - **Editer le fichier** en suivant la syntaxe [[raccourci-lanceur#avec_un_editeur_de_texte|décrite dans la partie modification avec un éditeur de texte]]. Exemple minimal <file bash une_app.desktop>
+[Desktop Entry]
+Type=Application
+Name=une app
+Exec=/home/un_utilisateur/applications/une_app
+</file>
+  - **Vérifier la syntaxe ''desktop-file-validate''** (ex : ''$ desktop-file-validate /usr/share/applications/une_app.desktop''). S'il n'y a aucune erreur, l'utilitaire n'affiche rien.
+  - Mettre à jour manuellement la base des lanceurs pour ne pas avoir à attendre la mise à jour automatique avec ''update-desktop-database'' (ex : ''$ update-desktop-database ~/.local/share/applications'').
 ==== Lancement d'un lanceur ====
 Si le fichier .desktop a l'attribut executable, on peut cliquer sur lui.
+Si gtk3 est installé, le lanceur peut être rapidement testé avec ''gtk-launch'' (ex : ''$ gtk-launch une_app.desktop'').
 Pour le lancer en ligne de commande, utiliser l'une des méthodes de cette page : [[https://ubuntuplace.info/questions/290/executer-un-fichier-desktop-dans-le-terminal|Exécution d'un fichier .desktop dans le terminal]]
 ===== Ajout d'une action =====
@@ Ligne 327: / Ligne 356: @@
 === Exemple ===
 {{ :raccourci-lanceur:quicklist.png|}}
 Pour obtenir le résultat ci-contre (illustré avec GNOME Shell), on modifie le lanceur de Firefox de la manière suivante :
 <file>
 [Desktop Entry]
@@ Ligne 333: / Ligne 362: @@
 # [Ici, le reste du lanceur normal pour firefox]
 # Nouvelle ligne pour lister les actions :
 Actions=new-window;new-private-window;
 # Nouvelles sections :
@@ Ligne 352: / Ligne 381: @@
   * Les lanceurs sont aussi utilisés pour lancer les [[:tutoriel:application_demarrage|applications au démarrage de la session]]
-  * (en) [[https://specifications.freedesktop.org/menu-spec/latest/|Les spécifications officielles du format de fichier .desktop]]
+  * (en) Spécifications officielles des formats des [[https://specifications.freedesktop.org/desktop-entry-spec/latest/|fichiers .desktop (Desktop Entry)]] et des [[https://specifications.freedesktop.org/menu-spec/latest/|menus (Desktop Menu)]].
+  * (en) [[https://help.gnome.org/admin//system-admin-guide/2.32/menustructure-desktopentry.html.en|Page d'aide de Gnome sur les fichiers .desktop]] qui décrit les variables d'environnement utilisés pour spécifié les chemins dans lesquels les //.desktop// sont lus.
   * [[:personnalisation|Le portail "personnalisation"]]
   * [[http://computing.travellingfroggy.info/article4/lxshortcut-creation-raccourcis-lxde|LXShortCut: création de raccourcis (icônes) pour le bureau de LXDE (Lubuntu) !]]
-  * (en) [[http://wiki.lxde.org/en/LXShortCut| doc de LXShortCut]]
+  * (en) [[https://wiki.lxde.org/en/LXShortCut| doc de LXShortCut]]
 ----