http://docs.kde.org/
Prev Next

Chapter 2. Adding a Menu Entry

Virgil J. Nisly

In this example, we will add Firefox to the Internet submenu.

To start off, we need to open KMenuEdit, so right mouse button on the application launcher menu, click Edit Applications... to start KMenuEdit. After KMenuEdit has started, select Internet as shown in picture below.

Select Internet

Once you have selected Internet, click on File → New Item..., opening the New Item dialog, as shown below. Type the name of the program you want to add, in this case, type firefox.

The New Item dialog.

Press return, and you should see something like the picture below in the main window.

The new item created.

Now lets fill in the Description:, in this case type Web Browser.

Note

The description and name will be displayed on the application launcher as “Web Browser (Firefox)”.

We will need to fill in the executable name in the Command: field, in this instance we will type firefox.

Note

Following the command, you can have several place holders which will be replaced with actual values when the program is run:

%f - a single file name
%F - a list of files; use for applications that can open several local files at once
%u - a single URL
%U - a list of URLs
%d - the folder of a file to open
%D - a list of folders
%i - the icon
%m - the mini icon
%c - the caption

For example: if you want to firefox to start your web browsing at www.kde.org - instead of firefox you would type firefox %u www.kde.org.

Most applications accept additional options e.g. the name of a defined profile like Konqueror or Konsole. To see all options for an application launch applicationname --help in Konsole.

We would like to have a more creative icon, so we will click the generic icon sitting beside Name: (note, the default icon may be blank, in which case click in the area to the right of the name entry box.) It will bring the Select Icon dialog which will let us choose the new icon, as shown below.

The Select Icon dialog.

We choose the firefox icon from the list, and press return. Your finished screen should probably look something like the screenshot below.

This is what the completed menu item should looks like.

Click File → Save, wait for the Updating System Configuration dialog to get finished, you should find Firefox in the application launcher Internet submenu!