Para onde devo colocar os arquivos .desktop para que apareçam no Desktop?

Coloque-os em ~/Desktop (ou $XDG_DESKTOP_DIR). Para entradas no menu de aplicações válidas para todos os usuários, use ~/.local/share/applications/. Entradas válidas para todo o sistema estão em /usr/share/applications/.

Qual é o conteúdo mínimo necessário para um arquivo .desktop de inicialização?

Você precisa do grupo [Desktop Entry] mais Type=Application, Name= e Exec=. Ícone e Comentário são opcionais, mas recomendados. O arquivo deve ser UTF-8 e ter a extensão .desktop.

Como escolher um ícone para meu lançador?

Defina Icon= para um nome de ícone do tema (por exemplo, utilities-terminal ou firefox), para que o sistema o procure em /usr/share/icons/, ou use um caminho absoluto para um arquivo PNG, SVG ou XPM (por exemplo, /usr/share/pixmaps/myapp.png).

Por que meu lançador não executa ou mostra o ícone correto?

Certifique-se de que o arquivo é executável (chmod +x) em alguns ambientes de desktop, que Exec aponte para um executável real (use o caminho completo ou um comando presente no PATH) e que Icon seja um nome ou caminho válidos. O TryExec pode ajudar a menus a ocultar entradas quebradas.

Posso executar um aplicativo de terminal a partir de um lançador de desktop?

Sim. Defina Terminal=true e use Exec= com seu comando. O lançador abrirá uma janela de terminal e executará o comando lá.

Como faço para criar um lançador que abre uma URL específica?

Use Type=Link, URL=https://…, e Name= e Icon= como de costume. Para Type=Application, use Exec= com um navegador, por exemplo, Exec=xdg-open https://example.com .

Como configurar lançadores de desktop no Ubuntu 24 com ícones padrão

Launchers de .desktop no Ubuntu 24 - Ícone, Exec, localizações

Conteúdo da página

Launchers de área de trabalho no Ubuntu 24 (e na maioria dos ambientes de desktop Linux) são definidos por arquivos .desktop: pequenos arquivos de configuração baseados em texto que descrevem um aplicativo ou link.

Uma vez que você saiba onde colocá-los e quais chaves configurar, como Icon= e Exec=, você pode adicionar lançadores personalizados à sua área de trabalho ou ao menu de aplicações. Este guia abrange como configurá-los e onde encontrar ícones padrão no Ubuntu para o campo Icon=.

ícones do ubuntu-desktop

O que é um arquivo .desktop?

Um arquivo .desktop é um Desktop Entry da freedesktop.org: um arquivo de texto em UTF-8 com a extensão .desktop. Ele possui um grupo [Desktop Entry] e pares de chave-valor. Três tipos são definidos: Aplicativo (iniciar um programa), Link (abrir uma URL) e Diretório (pasta no menu). Para os lançadores que você se importa, Aplicativo e, opcionalmente, Link são os mais relevantes.

O formato é usado pelo GNOME (padrão do Ubuntu), KDE, XFCE e outros. Entradas no sistema geralmente estão em /usr/share/applications/; para gerenciamento de pacotes no Ubuntu, novos arquivos .desktop aparecem no menu de aplicações. Lançadores definidos pelo usuário pertencem a ~/.local/share/applications/ (menu) ou ~/Desktop para que apareçam como ícones na área de trabalho.

Onde colocar os arquivos de lançador

Localização	Propósito
~/Desktop	Ícones na área de trabalho (quando a sua sessão usa este como `XDG_DESKTOP_DIR`)
~/.local/share/applications/	Entradas no menu de aplicações do usuário (sobrepõe as do sistema com o mesmo nome)
/usr/share/applications/	Entradas no menu do sistema (gerenciadas por pacotes; evite editar manualmente)

Para obter um lançador na área de trabalho no Ubuntu 24, coloque o arquivo .desktop em ~/Desktop. Para tê-lo apenas no menu de aplicações, coloque-o em ~/.local/share/applications/. Você pode usar o mesmo arquivo em ambos os lugares (por exemplo, copiar ou criar um symlink) se quiser que ele apareça no menu e na área de trabalho.

Conteúdo mínimo de um lançador

Para um lançador de Aplicativo você precisa:

Type=Application
Name= - rótulo mostrado nos menus e sob o ícone
Exec= - comando para executar (caminho do programa ou nome em PATH)

Opcionais, mas úteis: Icon=, Comment= (dica de ferramenta), Terminal= (executar no terminal), Path= (diretório de trabalho), TryExec= (verificar se o aplicativo está instalado). Todas as chaves são sensíveis ao caso.

Exemplo de lançador mínimo:

[Desktop Entry]
Type=Application
Name=Meu Script
Exec=/home/user/bin/my-script.sh

Salve como, por exemplo, ~/Desktop/my-script.desktop. Em alguns ambientes de desktop você pode precisar marcar como executável: chmod +x ~/Desktop/my-script.desktop.

A chave Icon=

Icon= pode ser:

Nome do ícone do tema (sem caminho) - por exemplo, Icon=utilities-terminal ou Icon=firefox. O desktop busca o ícone no tema atual sob /usr/share/icons/ (por exemplo, Yaru, Adwaita, hicolor). Esta é a opção preferida quando um ícone adequado existe na coletânea de ícones padrão.
Caminho absoluto - por exemplo, Icon=/usr/share/pixmaps/ubuntu-logo.svg ou Icon=/home/user/.local/share/icons/myapp.png. Use para ícones personalizados (PNG, SVG ou XPM).

Se o ícone estiver ausente, o desktop recorre a um padrão; o lançador ainda funcionará se Exec= estiver correto.

A chave Exec= e variáveis

Exec= contém o comando a ser executado. Você pode passar argumentos e usar variáveis definidas no padrão:

Variável	Significado
`%f`	Caminho único de um arquivo (por exemplo, um único arquivo selecionado)
`%F`	Vários caminhos de arquivos
`%u`	URL única
`%U`	Várias URLs
`%i`	Nome do ícone do arquivo de desktop (por exemplo, para notificação de início)
`%c`	Nome localizado
`%k`	Caminho para o arquivo .desktop

Exemplo: Exec=myeditor %f abre o arquivo selecionado no myeditor. Para um lançador simples sem argumento de arquivo/URL, um comando simples é suficiente: Exec=firefox ou Exec=/usr/bin/gnome-terminal.

Se o programa deve ser executado em um terminal (por exemplo, um script que precisa de um TTY), defina Terminal=true e use Exec= com o comando: Exec=/home/user/scripts/backup.sh.

Chaves opcionais úteis

Comment= - Descrição curta; frequentemente mostrada como dica de ferramenta.
GenericName= - Tipo genérico do aplicativo (por exemplo, “Navegador da Web”).
Categories= - Categorias do menu (só relevante para entradas em applications/); veja Desktop Menu Specification.
TryExec= - Caminho para o executável; se ausente ou não executável, a entrada pode ser ocultada dos menus (útil para aplicações opcionais).
Path= - Diretório de trabalho para o aplicativo.
StartupNotify= / StartupWMClass= - Para melhor comportamento da barra de tarefas/lançador quando o aplicativo inicia.

Exemplo: lançador de script personalizado na área de trabalho

[Desktop Entry]
Type=Application
Name=Backup Diário
Comment=Executar script de backup
Exec=/home/user/scripts/daily-backup.sh
Icon=utilities-terminal
Terminal=true
Path=/home/user

Salve como ~/Desktop/daily-backup.desktop, execute chmod +x ~/Desktop/daily-backup.desktop se seu desktop exigir isso, e o ícone deve aparecer na área de trabalho. Clicar duas vezes executa o script em um terminal.

Exemplo: lançador de link para site

Para um lançador que abre uma URL, use Type=Link e URL=:

[Desktop Entry]
Type=Link
Name=Wiki do Projeto
Comment=Abrir wiki do projeto no navegador
URL=https://wiki.example.com/project
Icon=web-browser

As mesmas regras para Name e Icon; o desktop abrirá URL com o navegador padrão ou manipulador.

Solução de problemas

Lançador não executa - Verifique Exec= (caminho completo ou comando em PATH). Para scripts, certifique-se de que eles sejam executáveis e que Terminal=true se eles precisarem de um terminal. Verificar sua versão do Ubuntu e o ambiente de desktop (GNOME vs KDE) pode ajudar quando o comportamento difere.
Ícone incorreto ou ausente - Use um nome de ícone de tema conhecido (por exemplo, de /usr/share/icons/Yaru/ ou ícones padrão) ou um caminho absoluto para um arquivo de imagem válido.
Não visível na área de trabalho - Confirme que o arquivo está em ~/Desktop, tem a extensão .desktop e (em algumas configurações) é executável. Para diferenças entre gerenciadores de arquivos (Nautilus vs Nemo, etc.), o tratamento da área de trabalho geralmente é o mesmo para arquivos .desktop em ~/Desktop.
Não no menu de aplicações - Coloque o arquivo em ~/.local/share/applications/. Se uma entrada do sistema com o mesmo nome de arquivo existir, o arquivo do usuário terá prioridade. Você pode instalar e gerenciar pacotes para adicionar ou remover arquivos .desktop do sistema.

Após editar arquivos .desktop, pode ser necessário atualizar o cache do menu; sair e entrar novamente ou executar update-desktop-database (se disponível) pode aplicar as mudanças.