Categories: Ubuntu

Single Command to Edit .desktop file in Ubuntu & other Linux

This simple tutorial shows how to edit .desktop files, the config files for your apps shown in start menu (app launcher), in Linux via single command.

In most Linux, the app icons (and their names) you see in dock & launcher are handled by .desktop files. If need, user can edit them by using either text editor or even third-party apps.

For software developing, scripting, or editing multiple .desktop files at the same time, there’s a command line tool that can help!

Table of Contents

Toggle

What you can do by editing .desktop file for your app:

The .desktop files are usually stored in following locations:

Find out the .desktop file for your app

If you don’t know where is the .desktop file, then try following steps to find it out.

Single command to edit the .desktop file

As far as I know, Debian, Ubuntu, Fedora, Manjaro, and their based systems have desktop-file-edit tool out-of-the-box for edit .desktop entries.

Option 1: To change app name, use command:

desktop-file-edit --set-name=NEW_NAME /path/to/file.desktop

In command, sudo is required for .desktop file in system directories.

For example, change the pre-installed Firefox (Snap version) in Ubuntu to “My Web Browser”:

sudo desktop-file-edit --set-name="My Web Browser" /var/lib/snapd/desktop/applications/firefox_firefox.desktop

Option 2: To change app icon, use command:

desktop-file-edit --set-icon=/path/to/icon /path/to/file.desktop

For icon file under /usr/share/icons, or .local/share/icons, just replace /path/to/icon-file with file-name without extension (e.g., .png, .svg).

Sponsored

For example, change the icon for my Firefox browser:

sudo desktop-file-edit --set-icon='/home/ji/Pictures/icons/myfirefoxicon.png' /var/lib/snapd/desktop/applications/firefox_firefox.desktop

Option 3: To add/remove category or mime type, use command:

desktop-file-edit --add-category=VALUE_HERE /path/to/file.desktop

Replace --add-category with one of the options below depends on which action you want to do:

--remove-category
--add-mime-type
--remove-mime-type

See list of well known categories.. And, right-click on a file and go to its ‘Properties’ to check “Type”.

Option 4: To add/edit other keys.

Use “–set-key=KEY_NAME –set-value=KEY_VALUE” option. You can add more than one pair of the options in single command.

For example, hide Firefox from app launcher by setting “NoDisplay=true“. It will add the key ‘NoDisplay’, if not exist.

sudo desktop-file-edit --set-key=NoDisplay --set-value=true /var/lib/snapd/desktop/applications/firefox_firefox.desktop

Option 5: To remove a key, use “–remove-key=KEY_NAME” option.

For example, un-hide Firefox by deleting “NoDisplay=true” from the .desktop file:

sudo desktop-file-edit --remove-key=NoDisplay /var/lib/snapd/desktop/applications/firefox_firefox.desktop

Option 6: Edit multiple desktop files

You can edit more than one files using for loop.

For example, hide all the Waydroid Android app icons associated with the .desktop files under .local/share/applications directory.

for file in $Home/.local/share/applications/waydroid.*.desktop; do desktop-file-edit --set-key=NoDisplay --set-value=true $file; done

In addition, the desktop-file-edit command will automatically validate the .desktop file after done editing it. It will output errors if validation not passed. For more, see its man page.

The post Single Command to Edit .desktop file in Ubuntu & other Linux appeared first on Osgrove.

See also The State of IoT – March 2022