## page was renamed from andreas-xavier/CreareAvviatoreProva
#format wiki
#language it
<<BR>>
<<Indice>>
<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?t=646597"; rilasci="16.04 18.04 20.04")>>

= Introduzione =

Le '''icone di avvio''' sono particolari file con estensione `.desktop`, generalmente contenuti nella cartella `/usr/share/applications`.

Questa guida contiene le istruzioni per creare e modificare '''manualmente''' le icone di avvio dei programmi, tramite un [[Ufficio/EditorDiTesto|editor di testo]] e senza l'utilizzo di software dedicati.

{{{#!wiki note
I principali [[AmbienteGrafico/FileManager|gestori di file]] nascondono l'estensione `.desktop`, visualizzando direttamente il nome del programma.
}}}

{{{#!wiki tip
Alcuni [[AmbienteGrafico|ambienti desktop]] dispongono di appositi [[AmbienteGrafico/IconeDiAvvio/ModalitàGrafica|tool grafici]] per creare e modificare le icone di avvio. In alternativa, è possibile [[AmministrazioneSistema/InstallareProgrammi|installare]] programmi come '''Alacarte''' o '''Menulibre'''.
}}}

<<Anchor(nuova)>>
= Creare le icone di avvio =

 0. Fare clic con il '''Pulsante destro''' del mouse sulla scrivania e selezionare '''''Nuovo documento → Documento vuoto'''''.
 0. Dare un nome al file appena creato aggiungendo l'estensione `.desktop`, ad esempio `NuovaApplicazione.desktop`.
 0. Aprire il file appena creato con un [[Ufficio/EditorDiTesto|editor di testo]] e copiare al suo interno il testo seguente, modificandolo secondo le proprie esigenze:{{{
[Desktop Entry]
Version=1.0
Name=NomeProgramma
Comment=Questo è un commento
Exec=/home/utente/Documenti/exec.sh
Icon=/home/Percorso Immagine/icona.png
Terminal=false
Type=Application
Categories=Utility;Application;
}}} Per informazioni relative alle voci precedentemente indicate, consultare la seguente tabella:

 ||<tablestyle="width:100%;" :13%>'''Parametro''' ||<:>'''Significato''' ||
 || '''Version''' || La versione del file `.desktop`. ||
 || '''Name''' ||Il nome con cui verrà visualizzata l'applicazione. Ad esempio: '''VLC media player'''. ||
 || '''Comment''' || Un breve testo che descrive le funzionalità dell'applicazione. Per esempio: ''Legge, acquisisce e trasmette i tuoi flussi multimediali''. ||
 || '''Exec''' || È il percorso all'eseguibile. Il percorso completo deve essere usato solo nel caso in cui non sia specificato nella variabile `$PATH`. Tutti i file eseguibili presenti nella cartella `/usr/bin` sono già inclusi in questa variabile, pertanto non è necessario specificarne il percorso completo. Per vedere tutti i percorsi inclusi nella variabile `$PATH`, aprire il [[AmministrazioneSistema/Terminale|terminale]] e digitare `echo $PATH`. ||
 || '''Icon''' || Specifica il percorso dell'icona utilizzata dal programma. Per le icone presenti nella cartella `/usr/share/pixmaps` non è necessario specificare il percorso completo, ma solo il loro nome senza l'estensione. Per esempio, se il file è `/usr/share/pixmaps/thunderbird.png`, indicare semplicemente come '''thunderbird'''. ||
 || '''Terminal''' || Specifica se il programma debba essere eseguito in una finestra di [[AmministrazioneSistema/Terminale|terminale]]. ||
 || '''Type''' || Specifica la tipologia dell'avviatore, che può essere `Application`, `Link` o `Directory` (ossia programmi, collegamenti o directory).   ||
 || '''Categories''' || Specifica la categoria in cui l'applicazione verrà inserita (Grafica, Internet, Ufficio ecc.). Il parametro è utilizzato per indicizzare l'applicazione in sotto-categorie dai vari tipi di menu ('''Dash''' di Unity, '''Lancelot''' di KDE, '''Whisker Menu''' di Xfce ecc.). Devono essere in inglese, i  possibili valori sono specificate [[https://specifications.freedesktop.org/menu-spec/latest/apa.html|qui]].  ||

 0. Salvare il file e chiudere.
## 0. Impostare i [[AmministrazioneSistema/PermessiFile#permessi|permessi di esecuzione]] al file `.desktop`, tramite uno dei metodi seguenti:
##  * '''[[AmministrazioneSistema/Terminale|Terminale]]''': digitare il comando seguente: {{{
##sudo chmod +x nome_file.desktop
##}}} sostituendo la voce `nome_file.desktop` con il percorso del file.
##  * '''Proprietà del file''': premere il '''Pulsante destro''' sul file, selezionare '''''Proprietà → Permessi''''' e spuntare la voce '''Consentire l'esecuzione del file ##come programma'''.

##Un file `.desktop` senza permessi di esecuzione sarà visibile nel seguente modo:<<BR>>
##{{attachment:not_execitable.png}}

##Lo stesso file con i permessi di esecuzione:<<BR>>
##{{attachment:executable.png}}

= Aggiungere l'icona di avvio al menu delle applicazioni =

 0. Salvare il file con estensione `.desktop` in una delle cartelle seguenti:
  * cartella `/usr/share/applications/`: l'icona di avvio del programma sarà disponibile nel menù delle applicazioni.
  * cartella `~/.local/share/applications/`: l'icona di avvio del programma sarà disponibile nel menù delle applicazioni, ma visibile solo all'utente che l'ha creata.

= Modificare le icone di avvio =

 0. Aprire una icona di avvio, tramite un [[Ufficio/EditorDiTesto|editor di testo]] con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]].

 0. Apportare i cambiamenti desiderati.

 0. Salvare il file modificato.

{{{#!wiki tip
È possibile inserire note o appuntare le modifiche apportate per agevolarne l'eventuale ripristino. A tale scopo basta commentare le righe in oggetto (cioè inserire come carattere iniziale il segno '''#''').
}}}

= Icone di avvio di Unity =

||<style="border:none;"> <<Immagine(./menu-icone-14.04.png)>> ||<style="border:none;"> In Ubuntu, le icone di avvio possono fornire anche un menu, contenente diverse '''scorciatoie''', accessibile premendo il '''Pulsante destro''' del mouse sulle icone del '''[[AmbienteGrafico/Unity/Glossario#Launcher|Launcher]]'''. <<BR>><<BR>>Per poter modificare una qualsiasi proprietà di un'icona di avvio, è necessario conoscere il nome esatto del file `.desktop` (si ricorda che il nome del file non è visibile da '''File''' in quanto, per un fattore "estetico", viene visualizzato direttamente il nome del programma). ||

Per trovare il nome di un file `.desktop` già presente nel '''Launcher''', digitare il seguente comando in una finestra di [[AmministrazioneSistema/Terminale|terminale]]: {{{
gsettings get com.canonical.Unity.Launcher favorites
}}}

Il risultato sarà simile al seguente: {{{
['nautilus-home.desktop', 'firefox.desktop', 'filezilla.desktop', 'ubuntu-software-center.desktop', 'qtcreator.desktop', 'ubuntuone-installer.desktop', 'wallch.desktop', 'gnome-terminal.desktop', 'gedit.desktop', 'audacious.desktop', 'gnome-control-center.desktop']
}}}

In generale, tenere a mente che solo due sono i percorsi possibili dei file `.desktop`:
 * `/usr/share/applications/`
 * `~/.local/share/applications/`

<<Anchor(scorciatoie)>>
== Scorciatoie delle icone di avvio ==

Per aggiungere delle '''scorciatoie''' ad una icona di avvio, seguire la procedura seguente.

 0. Aprire con un [[Ufficio/EditorDiTesto|editor di testo]] il file `.desktop` corrispondente all'applicazione che si desidera modificare. Qualora il file `.desktop` fosse posizionato nella cartella `usr/share/applications` sarà necessario aprirlo con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]].
 0. Aggiungere la riga '''Actions''', se assente:{{{
Actions=Nome1;Nome2;...;}}}
 0. Aggiungere una o più '''Desktop Action''', in funzione di quante scorciatoie si vuole aggiungere alla webapp:{{{
[Desktop Action Nome1]
Name=Scorciatoia Nome1
Exec=percorso/applicazione -opzione1
OnlyShowIn=Unity;

[Desktop Action Nome2]
Name=Scorciatoia Nome2
Exec=percorso/applicazione -opzione2
OnlyShowIn=Unity;
}}}
 0. Salvare il file `.desktop` così modificato.

Ora sarà possibile fare clic con il '''Pulsante destro''' del mouse sull'icona di avvio della applicazione posta nel '''Launcher''' per aprire il menu delle scorciatoie. Avviando tale applicazione tramite una '''scorciatoia''' del '''Launcher''', può capitare che essa venga aperta con una icona generica, poichè la '''Desktop Action''' appena creata non riconosce l'icona da utilizzare. Per correggere il problema:
 0. Avviare normalmente l'applicazione dall'icona del '''Launcher'''.
 0. Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il comando: {{{
xprop WM_CLASS
}}} quindi premere con un clic del mouse sull'applicazione in esecuzione.
 0. Prendere nota del risultato stampato nel terminale, che sarà simile al seguente:{{{
WM_CLASS(STRING) = "nomeapplicazione", "categoria"
}}}
 0. Chiudere l'applicazione, quindi aprire con un [[Ufficio/EditorDiTesto|editor di testo]] (se necessario anche con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]]) il file `.desktop` dell'applicazione appena chiusa.
 0. Inserire la riga:{{{
StartupWMClass=nomeapplicazione
}}} appena dopo la riga '''Exec''', salvare e chiudere.

Di seguito viene fornito un esempio di icona di avvio per '''Audacious''', un noto riproduttore musicale: {{{
[Desktop Entry]
Version=1.0
Type=Application
Name=Audacious
GenericName=Music Player
Comment=Listen to music
Icon=audacious
Categories=AudioVideo;Audio;Player;GTK;
Exec=audacious %U
TryExec=audacious
Terminal=false
MimeType=application/ogg;application/x-cue;application/x-ogg;application/xspf+xml;audio/midi;audio/mp3;audio/mpeg;audio/mpegurl;audio/ogg;audio/prs.sid;audio/x-flac;audio/x-it;audio/x-mod;audio/x-mp3;audio/x-mpeg;audio/x-mpegurl;audio/x-ms-wma;audio/x-musepack;audio/x-s3m;audio/x-scpls;audio/x-stm;audio/x-vorbis+ogg;audio/x-wav;audio/x-xm;x-content/audio-cdda;

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;
}}}

Le varie voci hanno i seguenti significati:

||<tablestyle="width:100%;" :15%>'''Parametro''' ||<:>'''Significato''' ||
|| '''Actions''' || dichiara il nome di una o più scorciatoie, separate da un punto e virgola. ||
|| '''Name'''    || dichiara il nome che verrà poi visualizzato nel menu. ||
|| '''Exec'''    || dichiara il comando che la voce del menù eseguirà. ||
|| '''!OnlyShowIn''' || dichiara l'ambiente grafico in cui visualizzare la scorciatoia. ||

{{{#!wiki tip
Per ottenere una lista completa dei comandi disponibili per l'applicazione desiderata, è possibile utilizzare il comando '''man''' seguito dal nome dell'applicazione.
}}}

= Icone di avvio personalizzate =

La creazione di icone di avvio tramite [[Ufficio/EditorDiTesto|editor di testo]] permette una elevata personalizzazione delle stesse. Di seguito vengono indicati alcuni esempi di icone personalizzate.

== Firefox in navigazione anonima ==

Alcuni ambienti grafici, come [[AmbienteGrafico/Xfce|XFCE]] e [[AmbienteGrafico/Lxde|LXDE]], non possiedono una funzionalità per lanciare il browser '''Firefox''' direttamente in navigazione anonima (disponibile ad esempio con clic destro sull'icona nel [[AmbienteGrafico/Unity/Glossario#Launcher|Launcher]] di '''Unity'''). È possibile creare un'icona di avvio per tale scopo, utilizzando il seguente modello:{{{
[Desktop Entry]
Version=1.0
Name=Firefox Web Browser (private browsing)
Name[it]=Firefox Browser Web (navigazione anonima)
Comment=Browse the World Wide Web anonimously
Comment[it]=Esplora il web anonimamente
GenericName=Web Browser
GenericName[it]=Browser web
Keywords=Internet;WWW;Browser;Web;Explorer
Keywords[it]=Internet;WWW;Browser;Web;Navigatore
Exec=firefox -private-window
Terminal=false
X-MultipleArgs=false
Type=Application
Icon=firefox
Categories=Network;WebBrowser;
MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;application/rdf+xml;image/gif;image/jpeg;image/png;x-scheme-handler/http;x-scheme-handler/https;x-scheme-handler/ftp;x-scheme-handler/chrome;video/webm;application/x-xpinstall;
StartupNotify=true
Actions=NewWindow;NewPrivateWindow;

[Desktop Action NewWindow]
Name=Open a New Private Window
Name[it]=Apri una nuova finestra anonima
Exec=firefox -private-window

[Desktop Action NewPrivateWindow]
Name=Open a New Private Window
Name[it]=Apri una nuova finestra anonima
Exec=firefox -private-window
}}}

== File manager come root ==

L'icona d'avvio personalizzata è usabile coi seguenti [[AmbienteGrafico/FileManager|file manager]], [[AmbienteGrafico/FileManager#ubuntu|Nautilus]], [[AmbienteGrafico/FileManager#xubuntu|Thunar]], [[AmbienteGrafico/FileManager#mate|Caja]], [[AmbienteGrafico/FileManager#lubuntu|PCManFM]], [[AmbienteGrafico/FileManager#Nemo|Nemo]] e [[AmbienteGrafico/FileManager#Xfe|Xfe]].

[[AmministrazioneSistema/InstallareProgrammi|Installare]] i pacchetti [[apt://menu, menu-l10n|menu e menu-l10n]].

Nel seguente esempio sostituire ''file_manager'' col nome di quello usato:{{{
Desktop Entry]
Name=Thunar (root)
Name[it]=Thunar (root)
Comment=Open the specified folders as administrator
Comment[it]=Apre le cartelle indicate come amministratore
GenericName=Open Folder
GenericName[it]=Apri cartella
TryExec=Thunar
Exec=su-to-root -X -c file_manager %u
Icon=system-file-manager
NoDisplay=false
Terminal=false
StartupNotify=true
Type=Application
Categories=System;Utility;FileTools;FileManager;
MimeType=inode/directory;
}}}

= Ulteriori risorse =

 * [[https://help.ubuntu.com/community/UnityLaunchersAndDesktopFiles|Documento originale]]
 * [[https://specifications.freedesktop.org/menu-spec/latest/index.html|Specificazioni Freedesktop per creare menù (in lingua inglese)]]

----
CategoryGrafica