Modificare il Launcher Unity con Unity Launcher Editor

Unity Launcher Editor (ULE) è uno script Python che semplifica la modifica del launcher di Unity: aggiunge/rimuove applicazioni e crea/modifica le voci quicklist senza editare manualmente i file .desktop. Questo articolo spiega come installarlo, usarlo, risolvere i problemi comuni e offre checklist e runbook per rollback.

Definizione rapida: Unity Launcher Editor (ULE) è uno script Python che modifica il contenuto del launcher di Unity e le voci quicklist associate alle applicazioni.

Perché usare ULE

ULE evita l’editing manuale dei file .desktop e la copia a mano in ~/ per aggiungere o cambiare quicklist. È utile se vuoi personalizzare velocemente le azioni nel menu contestuale del launcher.

Installazione

Unity Launcher Editor non è disponibile nei repository ufficiali di Ubuntu né in un PPA pubblico (al momento di pubblicazione di questa guida). Per installarlo bisogna scaricare il codice sorgente da Launchpad usando Bazaar (bzr).

Esegui questi comandi nel terminale per installare Bazaar e scaricare il codice:

sudo apt-get install bzr
bzr branch lp:unity-launcher-editor

Dopo il download, troverai una cartella chiamata “unity-launcher-editor” nella tua home. Apri Nautilus e naviga in unity-launcher-editor/unitylaunchereditor. Fai doppio clic sul file main.py per avviare l’interfaccia grafica. Apparirà una finestra di esecuzione:

Clicca su Run per avviare l’applicazione.

Usare Unity Launcher Editor

Interfaccia in breve: a sinistra vedi le applicazioni attualmente nel launcher. A destra trovi i dettagli dell’app selezionata nella parte superiore e le voci quicklist nella parte inferiore.

Per aggiungere una voce quicklist a un’app già presente (esempio: Firefox):

1. Seleziona l’icona dell’app (Firefox) nel pannello sinistro.
2. Sotto Quicklist Group, clicca il pulsante +.

3. Inserisci il nome del gruppo quicklist e il comando da eseguire. Ad esempio, per aprire Firefox in modalità privata usa il comando che avvia una nuova sessione privata.

4. Clicca Save.

La voce quicklist dovrebbe apparire immediatamente nel launcher. Se non la vedi, effettua il logout/login oppure riavvia Unity con il comando:

unity --replace

Suggerimenti d’uso

• Verifica i comandi inseriti: devono essere eseguibili dall’utente. Se il comando richiede percorsi assoluti, specificali.
• Se la voce non funziona, controlla i permessi del file .desktop e la sintassi della riga Exec.

Aggiungere un’applicazione al launcher

ULE permette anche di creare e aggiungere una nuova applicazione al launcher in due passaggi:

1. Clicca il pulsante + in basso nel pannello sinistro. Inserisci il nome del launcher.

2. Seleziona la nuova voce e modifica le informazioni nella parte superiore del pannello destro (nome, comando, icona, categoria).

Importante: il metodo più rapido per aggiungere un’app al launcher rimane avviare l’app e poi cliccare con il tasto destro sull’icona nel launcher e scegliere “Keep in launcher”.

Quando ULE non è la soluzione migliore

• Se preferisci modificare direttamente i file .desktop, l’editing manuale resta più controllabile per utenti avanzati.
• In ambienti gestiti (desktop enterprise) la politica di sistema può sovrascrivere le modifiche locali.
• Se Unity è obsoleto o non installato, ULE non è applicabile.

Approcci alternativi

• Editing manuale: copia il file .desktop in ~/.local/share/applications, modifica la sezione [Desktop Entry] e aggiungi la chiave X-Ayatana-Desktop-Shortcuts o Actions.
• Utilizzare dconf/gsettings per alcune impostazioni del launcher (più limitato per quicklist).
• Script personalizzati che generano .desktop basati su template.

Troubleshooting rapido

• Vedi la voce ma non funziona: controlla la riga Exec nel .desktop e i permessi.
• L’interfaccia non si avvia: assicurati di usare Python compatibile e che bzr abbia scaricato tutti i file.
• Modifiche non visibili: effettua logout/login o esegui unity --replace.

Runbook di rollback

Se una modifica causa problemi visibili, segui questi passi per annullarla:

1. Apri ULE e rimuovi la voce quicklist o l’app aggiunta.
2. Se hai una copia di backup del file .desktop, ripristinala in ~/.local/share/applications.
3. Riavvia Unity con unity --replace o effettua logout/login.
4. Se il problema persiste, elimina la voce corrispondente da ~/.config/unity3d o dalla directory di configurazione locale pertinente.

Checklist per ruolo

• Utente finale:
  • Avvia l’app e prova l’azione della quicklist.
  • Seleziona “Keep in launcher” per aggiunte rapide.
• Power user:
  • Controlla Exec e Icon nei .desktop.
  • Testa i comandi nel terminale prima di salvarli.
• Amministratore di sistema:
  • Verifica che le politiche di sistema non sovrascrivano ~/ modifiche.
  • Mantieni backup dei .desktop critici.

Casi di test e criteri di accettazione

• Creare una voce quicklist per aprire una nuova finestra privata in Firefox: clic sulla voce apre la finestra privata.
• Aggiungere una nuova applicazione: l’icona appare nel launcher e l’app si avvia correttamente.
• Rimozione rollback: dopo il rollback, il launcher torna allo stato precedente senza errori visibili.

Glossario in una riga

• ULE: Unity Launcher Editor, script Python per modificare il launcher.
• Quicklist: azioni rapide disponibili dal menu contestuale dell’icona nel launcher.
• .desktop: file di descrizione di un’applicazione usato da desktop environment.
• Unity: ambiente desktop sviluppato originariamente da Canonical per Ubuntu.

Annuncio breve

Unity Launcher Editor rende semplice personalizzare le azioni rapide del launcher di Unity. Scarica il codice da Launchpad, avvia main.py e gestisci applicazioni e quicklist con un’interfaccia grafica pulita. Ideale per utenti che vogliono più controllo senza editare manualmente file di sistema.

Riepilogo

• ULE semplifica la creazione e la modifica delle quicklist.
• Installa da Launchpad con bzr, poi avvia main.py.
• Usa il pannello sinistro per selezionare app e la parte destra per aggiungere quicklist.
• In caso di problemi, ripristina il file .desktop o riavvia Unity.

Note importanti:

• Non modificare file di sistema senza backup.
• Alcune modifiche potrebbero richiedere il logout per essere visibili.