Jérémy
Quentin
Emmanuel
Lepage Vallee

# Basic use of &sflphone-client-kde;

Although &sflphone; is enterprise oriented, its interface is very easy to use and you can use the basic features without any particular skills or knowings.

## Presentation of the main window

The main window is composed of four main parts: the current call list, the history list, the bookmark list and the contact list. By default, they are stacked, but it is possible to separate them by using the drag and drop handle on top of each "tab" of the application. Note that this handle is disabled in the current call list.

### The call page

To switch between those windows, click on the History, Bookmark and Address Book tabs on the bottom of the screen. Each tab page can be docked on the left or right of the call page and tabbed in various configurations.

The default call list

The current call list is composed on the list itself, hosting call and conferences. There is also an optional dial pad, instant message box and volume controls. They can be enabled or disabled from the View menu.

The view menu

### The History page

The history list host the previous calls. It is possible to sort it in multiple ways. By default, it ordered from the most recent to the most ancient call with "smart" categories. A filter text box is available for quick searches.

The History tab

By default, each call display if the call is incoming, outgoing or missed as emblems in the bottom right of the widget. It also display the peer name using the contact information or the name provided by the phone server. If a call has a recording, the play and remove buttons will be displayed.

### The Contact page

The contact list provide an easy access to KDE address book contacts. By default, it is sorted by alphabetical order, but can also be displayed in various other orders. A quick search text field is also provided. Contacts with multiple phone numbers are collapsed by default. To display all numbers it is possible to double click on the collapsed item in the list or activate the option in the Display page of the configuration dialog. The information being displayed are also configurable from that same page. Users with many contacts might want to display minimal details to reduce the size of the contacts.

The Contact tab

### The Bookmark page

The Bookmark page allow to save some phone numbers to be more accessible. This is done by clicking with the &RMB; on a contact or a history item and pressing the Bookmark option. It also displays the 10 most used numbers.

## Making a call

### Dialing one's number

If you know the number of the people you want to call, you may just type it on the dial pad or on your keyboard while you are in the &i18n-current-w;, then click on the Accept button in the &i18n-actions-p;'s toolbar or in the Actions menu, or press &Enter; on your keyboard, or double-click on the number to call once you have finished dialing it.

Following behavior, common part...

### Calling from call history

If you want to call somebody from whom you missed a call, or you already called earlier, you may go to the &i18n-history-w;. The detailed use of this window and its features (search, &etc;) is described in this section. Once you are in it, find the number or name of the person you want to call, then you can double click on the history call, drag and drop it on the current call list, pressing &Enter; or right clicking and press Call Again.

### Calling from address book

If you have configured contacts in either KAddressBook or Akonadi, &sflphone-client-kde; should automatically import them. To call a contact, it is possible to double click on it, drag and drop it to the current call list, press &Enter; or right click and select Call.

If the contact have multiple phone numbers, a dialog will be shown to select the right number.

Multiple number popup

If your addressbook contain incomplete phone numbers or only phone extensions, it is possible to set a "default account" in the "Basic" tab of the account configuration dialog. This account will be used to call these numbers. If you have incomplete phone number belonging to multiple accounts, it is advised to edit those contacts to ensure the number is complete or add @hostname at the end of the number (replace hostname with a valid server hostname).

## Basic call actions

Call actions

### Receiving a call

When one of the account registered in &sflphone; receives an incoming call, it will be displayed as a new item in the &i18n-current-w; with the "incoming" icon. You can either accept or refuse it. To accept it, select the item and click on the Accept button which replaced the Call button in toolbar and Actions menu, or double click the item, or press &Enter;. To refuse it, select it and click on the refuse button that replaced the Hang up button in toolbar and Actions menu or press &Esc;.

Following behavior, common part...

### The call is ringing

Once you called a number, the call is normally in ringing state. It will then pass to Current or Busy state, according to the decision of the called peer to accept or refuse the call. If it is in Busy state, you can just hang it up with the Hang up button or pressing &Esc;.

If the number does not exist or if any other error occurred (see the list of common errors here), it is in failure state, then you can hang it up with the Hang up button or pressing &Esc;.

Following behavior, common part...

### The call is current

Once the call is in current state, you can now communicate with your peer. You have a bunch of useful features when in current state that are described in the common use chapter. To end the call, select it and click on Hang up button in toolbar or pressing &Esc;.

### The call is recording

Recording a call will create a `.wav` file in the directory chosen in the Audio configuration dialog. Recording can be activated by pressing the Record button of the toolbar. The call emblem should turn to:

The record emblem

Once the call is over, you can play the recording from the history page be pressing the play button. This overlay should appear.

The record overlay

### The call is being transferred

SFLPhone support two types of transfer, direct and attended. Attended will be discussed in the next section. Direct transfer is the action of transferring a call to another number. Once the call is transferred, it is considered over by SFLPhone. It should start ringing on the number you transferred to. To transfer a call, press on the Transfer button in the toolbar. This overlay should be presented:

The transfer overlay

## Managing calls

SFLPhone support multiple calls at once. Managing multiple call offer many features, but it is also important to understand the relation between them. In theory, only 1 call or group of calls, referred here as conferences, can be active. Other calls are going to be on hold. A call on hold can not communicate, be it by instant message or voice unless it is activated again. Double click or press &Enter; to re-activate the call. Active call should have a green icon emblem are be more saturated than inactive calls.

Conferences are a group of intercommunicating calls. Each participant of a conversation can hear all the other participants. However, it is important to note that if a conference have been created in SFLPhone, the other participants would not know about it, so it is useful to actually tell them they are in a conference.

Call management is mostly using drag and drop. Dragging a call on another call will result in this overlay being displayed.

Call overlay

Dropping the call on "conference" will add the call being dropped to the conference of the call it is drop on to. If the later is not part of a conference, one will be created. Dropping the call on transfer will trigger an attended transfer. Attended transfers will give ownership of the call being dropped to the owner of the call it is being dropped onto. It is useful if you want to notice the person you are transferring the call to before actually transferring it. You put the person on hold, call the second one, then perform an attended transfer. The call will then be removed and considered over.

Dropping a call on an history call will display this overlay:

History overlay

It will trigger a direct transfer. The phone of the person you are transferring to should start ringing. The call will be removed and considered over. This feature is also available for contacts:

Contact overlay

## Account configurations

For the account setup wizard, please refer to the Getting Started chapter of this handbook.

Advanced configuration of the accounts is available in the Account section of the configuration dialog. The page is divided in two sections, the accounts list and the configurations tabs.

### The account list

The account list allow to enable or disable account by checking them, moving account priority use the up and down buttons, adding and removing them using the add and remove buttons.

Account list

The tinted background represent the account state. Normal represent a disabled account, red an invalid or inaccessible account, yellow an account in the process of registering itself and green a valid, registered account. The icons represent the current local status of the account. A little floppy represent a modified and unsaved account and the reload icon an account that have changed on the server or by another client, like the plasmoid and need to be reloaded.

### Basic settings

Basic account dialog

This tab allow to configure the basic credentials of a SIP account. The default resolve account checkbox is used to know if that account have priority when performing contact information lookup.

The settings in the basic tab are often present in other tab in more advanced details. The credential tab allow to configure chained credentials, this feature is rarely used and you should avoid using them unless you really need to.

Chained credentials

It is also possible to enable Secure SIP in the security dialog. Most accounts are used in an intranet or using a VPN, so they are not secured. But if your account is, the Security dialog is here for you.

Account security

The advanced dialog host some rarely used configuration such as the default network interface, alternative ports and STUN server.

Advanced settings

The ringtone dialog allow to select a ringtone from the default list or from a file on your disk.

Ringtone settings

Finally, the codec tab allow to enable or disable codecs or change their priority. That way, it is possible to have higher quality call or save bandwidth. Some video codecs also have configuration parameter of their own.

Codec settings

## Other configurations

SFLPhone KDE also have settings not related to SIP accounts. Those settings allow to configure how the application look and behave.

### Display

Display settings

The display page allow various configurations related to how the application look. The first subsection, Display Main Window configure when SFLPhone will pop-up the GUI when it is minimized in the system tray. The second, Notifications, configure when SFLPhone should display a notification pop-up. The third, Visible Call Details enable or disable various information fields in the call item. It also allow to select a minimum size for call items, to make them easier to target with the mouse. The last section, Visible Contact Details do the same for the contact items.

### Audio

Display settings

The audio config allow you to select between PulseAudio and ALSA. It also make it possible to select devices for various operation, like ringing.