# Xfce 4 Preferred Applications

&date;
2004 2005 2006 Benedikt Meurer

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is available from the Free Software Foundation.

Benedikt Meurer

    benny@xfce.org

This manual describes version &version; of the Xfce Preferred Applications framework and its components.

## Introduction

Throughout the 4.x series of the Xfce Desktop Environment, there was no easy way for users to set their preferred applications, i.e. the Web Browser that should be used to open hyperlinks. The Xfce Preferred Applications framework was added in Xfce 4.3 to overcome this limitation and provide users with an easy way to select their preferred web browser, mail reader and terminal emulator.

## Configuration

You can access the configuration dialog by clicking on the Preferred Applications button in the Xfce Settings Manager. The configuration dialog is split into two pages, which are described in the following sections.

### Internet applications

The first page of the configuration dialog allows you to select your preferred Web Browser and Mail Reader. The selected Web Browser will be used to open hyperlinks that you click on and to display the documentation, whereas the Mail Reader will be used to compose mails.

Internet applications

Select internet applications

To select a different Web Browser than the current default one, click on the button in the Default Web Browser section and a list of web browsers that were detected on your system will appear, as shown in .

Select Web Browser

Select Web Browser

If the Web Browser you are looking for is not automatically detected by the system, you can select Other... from the drop down menu and a dialog will appear asking you to enter the command for the custom Web Browser, as shown in .

Specify a custom Web Browser

Specify a custom Web Browser

The special marker `%s` in the command will be substituted with the URL when you click on a hyperlink. When running just the preferred Web Browser without any URL, i.e. using `exo-open --launch WebBrowser`, only the binary of the specified command will be used and the parameters will be stripped off. In the example above, with `mywebbrowser "%s"` as custom Web Browser, the command `mywebbrowser` will be used to open the Web Browser without an URL.

### Other applications

The first page of the configuration dialog allows you to select your preferred terminal emulator. The preferred terminal emulator will be used throughout the Xfce Desktop Environment to launch applications that need to be run in a CLI (command line interface) environment.

Other applications

Select other applications

For custom terminal commands, the special marker `%s` will be substituted with the application to run in the terminal. Otherwise the same rules apply as described in .

## exo-open

A simple command line frontend to the Xfce Preferred Applications framework is included, named exo-open. Users and developers can use this utility to launch the preferred application for a certain category or open URLs with the default URL handler.

exo-open supports two operation modes. The first will simply launch the preferred application for a certain category, optionally passing a parameter (the exact meaning of the term parameter depends on the category). For example, to launch the command `mutt` in the preferred Terminal Emulator, you would use

    exo-open --launch TerminalEmulator mutt

while to just open the preferred Web Browser, the following command would be used:

    exo-open --launch WebBrowser

The second mode supported by exo-open opens all parameters passed to it with the default URL handlers. Here URLs mean either fully qualified URLs (i.e. `http://www.xfce.org/` or `mailto:xfce4-dev@xfce.org`) or local paths (i.e. `/home/dude/myfile.txt`). For example to open `/home/dude/file1.mp3` and `/home/dude/file2.txt` in the default applications, you would use the following command:

    exo-open /home/dude/file1.mp3 /home/dude/file2.txt

To start composing a mail to the xfce4-dev mailing list, you can do:

    exo-open mailto:xfce4-dev@xfce.org

## About

The Xfce Preferred Applications framework and its components was written by Benedikt Meurer (benny@xfce.org) for the Xfce Desktop Environment. For more information, please visit the Xfce website.

To report a bug or make a suggestion regarding the software or this manual, use the Xfce Bug Tracking System (Product: `libexo`, Component: `helpers`).

If you have questions about the use or installation of this package, please ask on the xfce mailing list. Development discussion takes place on the xfce4-dev mailing list.

This software is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.