<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kmess '<application>KMess</application>'> <!ENTITY kapp "&kmess;"><!-- replace kmess here --> <!ENTITY version '2.0'> <!ENTITY tarversion '2.0'> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"><!-- change language only here --> <!-- Do not define any other entities; instead, use the entities from kde-genent.entities and $LANG/user.entities. --> ]> <!-- ................................................................ --> <!-- The language must NOT be changed here. --> <book lang="&language;"> <bookinfo> <title>The &kapp; Handbook</title> <date>2009-03-27</date> <releaseinfo>&version;</releaseinfo> <authorgroup> <author> <firstname>Mike</firstname> <othername>K.</othername> <surname>Bennett</surname> <affiliation> <address><email>mkb137b@hotmail.com</email></address> </affiliation> </author> <author> <firstname>Diederik</firstname> <othername></othername> <surname>van der Boor</surname> <affiliation> <address><email>vdboor@codingdomain.com</email></address> </affiliation> </author> <author> <firstname>Valerio</firstname> <othername></othername> <surname>Pilo</surname> <affiliation> <address><email>valerio@kmess.org</email></address> </affiliation> </author> <author> <firstname>Heimen</firstname> <othername></othername> <surname>Stoffels</surname> <affiliation> <address><email>cooleboy121HS@hotmail.com</email></address> </affiliation> </author> <author> <firstname>Panagiotis</firstname> <othername></othername> <surname>Papadopoulos</surname> <affiliation> <address><email>pano_90@gmx.net</email></address> </affiliation> </author> </authorgroup> <!-- TRANS:ROLES_OF_TRANSLATORS --> <copyright> <year>2002</year> <holder>Mike K. Bennett</holder> </copyright> <copyright> <year>2007</year> <holder>Diederik van der Boor</holder> </copyright> <copyright> <year>2009</year> <holder>Valerio Pilo</holder> </copyright> <!-- Translators: put here the copyright notice of the translation --> <!-- Abstract about this handbook --> <abstract> <para> &kapp; is an alternative &Windows; Live Messenger chat client for &Linux;. It allows &Linux; users to chat with friends who use &Windows; Live Messenger on &Windows; or MSN Messenger on &MacOS;. The strength of &kapp; is its integration with the K Desktop Environment (&kde;), its focus on &Windows; Live Messenger specific features and an interface which is both clean and easy to use. </para> </abstract> <!-- keywords for indexing by search engines. --> <keywordset> <keyword>KDE</keyword> <keyword>KMess</keyword> <keyword>Chat</keyword> <keyword>Windows Live</keyword> <keyword>Live Messenger</keyword> <keyword>MSN</keyword> <keyword>Client</keyword> <keyword>Messenger</keyword> <keyword>Instant Messenger</keyword> <keyword>IM</keyword> </keywordset> <!-- Add the free documentation notice, see fdl-notice.docbook --> <legalnotice>&FDLNotice;</legalnotice> </bookinfo> <!-- contents start here. The identifiers are also used as file names --> <chapter id="introduction"> <title>Introduction</title> <para> &kapp; is an alternative Instant Messaging client for &Linux;. </para> <!-- The introduction chapter contains a brief introduction for the application that explains what it does and where to report problems. Basically a long version of the abstract. Don't include a revision history. (see installation appendix comment) --> <para> Instant Messaging is a form of real-time communication, commonly involving hand-typed chat messages. This can be considered more akin to genuine conversation than the email's <quote>letter</quote> format. In contrast to email, the parties always know whether their peer is available to start an interactive chat conversation. </para> <para> &kapp; is specifically designed to access the &Windows; Live Messenger Service, an Instant Messaging service developed by &Microsoft;. This allows &Linux; users to chat with friends and colleagues who use MSN Messenger in &Windows; or &MacOS; X. MSN Messenger has been renamed to &Windows; Live Messenger in February 2006. Its name is still commonly known and often shortened to <quote>MSN</quote>, or nowadays <quote>WLM</quote>, by its users. </para> <para> The strengths of &kapp; are its integration with the K Desktop Environment (&kde;), the focus on &Windows; Live Messenger specific features and a clean and easy-to-use interface. Like many &Linux; and &kde; applications, &kapp; is free software. The licensing terms are the &GNU; General Public License. </para> <para> Some feature highlights: </para> <!-- This list should be used to advertise the coolest stuff we have. --> <itemizedlist> <listitem><para> Communicate with contacts who use other &Windows; Live Messenger client software. </para></listitem> <listitem><para> Rich, colorful chat styles. </para></listitem> <listitem><para> Multiple accounts are supported. </para></listitem> <listitem><para> Chat log browser to show old discussions. </para></listitem> <listitem><para> Chat logs styled as the original conversation. </para></listitem> <listitem><para> Fast file transfers including thumbnail previews for any file type. </para></listitem> <listitem><para> Automatic reconnection in case of connection failure. </para></listitem> <listitem><para> Chat windows can be used again after reconnecting. </para></listitem> <listitem><para> Non invasive and customizable notifications and warning messages. </para></listitem> <listitem><para> Notifications can be blocked when the status is set to Busy. </para></listitem> <listitem><para> Nudges can be blocked, winks can be hidden. </para></listitem> <listitem><para> Annoying custom emoticons can be blacklisted. </para></listitem> <listitem><para> Many options to customize the chats and the contacts list. </para></listitem> </itemizedlist> <para> At the moment, &kapp; supports these WLM-specific features: </para> <!-- This list should be used to advertise our MSN protocol support. --> <itemizedlist> <listitem><para> Display pictures exchange. </para></listitem> <listitem><para> Fast file transfers. </para></listitem> <listitem><para> Chatting with offline and invisible contacts. </para></listitem> <listitem><para> Nudges. </para></listitem> <listitem><para> Custom emoticons. </para></listitem> <listitem><para> Winks. </para></listitem> <listitem><para> Ink (hand-written) messages. </para></listitem> <listitem><para> Exchange of <quote>Now Playing...</quote> information. </para></listitem> <listitem><para> Email notifications for Hotmail/Live Mail accounts. </para></listitem> <listitem><para> <quote>Messenger Plus!</quote> features: text formatting, tabbed chat windows. </para></listitem> </itemizedlist> </chapter> <chapter id="using-kapp"> <title>Using &kapp;</title> <!-- This chapter should tell the user how to use your app. You should use as many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document your application. --> <!-- Note that all graphics should be in .png format. Use no gifs because of patent issues. Use the default KDE style for all screenshots (Oxygen widget, color scheme and window borders). --> <sect1 id="login"> <title>Logging in</title> <para> Because &kapp; is a &Windows; Live Messenger client, you need to have an account at the online &Windows; Live Service. If you already have an existing account - ⪚ you have used &Windows; Live Messenger before - you can use this account for &kapp; too. Otherwise, you can create an account at the &Microsoft; Passport web site. After you created the account, you can log in to use &kapp;. </para> <sect2 id="login-create-account"> <title>Creating an Account</title> <para> To create a new account, you can either create a new free &Windows; Live Hotmail address, or register your own email address at <ulink url="http://register.passport.com/">register.passport.com</ulink> . A link to this site is also found at the login screen of &kapp; After you have completed the registration process, you can use your email address to login. </para> <para> You will also receive a confirmation email from the &Windows; Live Service. This email contains a link which you have to click on in order to confirm your account. Until you have confirmed your account, your account will be restricted: you will only be able to add very few contacts and you will not be able to change your own friendly name. You can ask the &Windows; Live Service to send you another confirmation email by clicking on the <quote>Request verification email</quote> link in the account settings page of &kapp;. </para> <para> You can manage the accounts saved within &kapp; from the &kapp; settings dialog. To learn more about it, see <xref linkend="settings-kmess-accounts"/>. </para> </sect2> <sect2 id="login-init"> <title>Logging in</title> <para> Enter the email address and the password of your account to connect. It is recommended to enable the <guilabel>Remember account</guilabel> option, as it saves your account preferences before you quit &kapp;. If you want &kapp; to store your password, you can also enable the <guilabel>Remember password</guilabel> checkbox. Use <guibutton>Connect</guibutton> to continue. </para> <para> To ease the login process by only using the keyboard, you can press 	 to switch to the next field after you are done filling it, then press &Enter; to start connecting. If your account email is already memorized by &kapp; just choose it from the drop-down list. The display picture will reflect the last known picture for that account or the &kapp; logo if none was found. Clicking on the display picture will open the settings of the selected account, using the mouse <mousebutton>wheel</mousebutton> will switch between the saved accounts. </para> <para> You should <emphasis>not</emphasis> enable the <guilabel>Remember account</guilabel> option, if you are using a public computer: this is because others may see your email address or even use your account without authorization. If you choose not to remember the account, it will disappear when you logout or exit &kapp;. Also any changes made to the settings of a guest account will be lost. </para> <para> If the &kde; Wallet is enabled in your &kde; installation (and it is by default), you may see a confirmation dialog or a quick wizard you can use to protect your account passwords. This will only appear once, and the next times you will only be prompted for your wallet's password, to unlock the &kapp; passwords. However, if the &kde; Wallet is not available, &kapp; will store the unencrypted account passwords in the file <filename>~/.kde4/share/config/kmessrc</filename> (<filename>~</filename> is your home directory). This file is not accessible by other users of your system, so it is not seen as a security issue. If you do not wish to have your password saved anywhere at all, or if you are on a public computer, uncheck the <guilabel>Remember password</guilabel> checkbox provided in &kapp;'s startup screen. </para> <screenshot> <screeninfo>The &kapp; startup screen</screeninfo> <mediaobject> <imageobject><imagedata fileref="startupscreen.png" format="PNG"/></imageobject> <textobject><phrase>The &kapp; startup screen</phrase></textobject> </mediaobject> </screenshot> <para> After logging in, your contact list appears. This is described in the next section. </para> </sect2> </sect1> <sect1 id="using-list"> <title>Using the Contact List</title> <para> The contact list gives you an organized overview of the buddies (the <quote>contacts</quote>) you can chat with. To view the contact list, you need to be logged in first. The following image gives an example of a typical contact list: </para> <screenshot> <screeninfo>The main window and contact list</screeninfo> <mediaobject> <imageobject><imagedata fileref="contactlist.png" format="PNG"/></imageobject> <textobject><phrase>The main window and contact list</phrase></textobject> </mediaobject> </screenshot> <para> To start chatting with a contact, just click his or her name on the list. Please note that many of the actions and operations you can perform on the items of the contact list, can be performed directly by clicking the &RMB; on the contact. This will pop up the following context menu: </para> <screenshot> <screeninfo>The context menu of a contact in the contact list</screeninfo> <mediaobject> <imageobject><imagedata fileref="contactlist-contextmenu.png" format="PNG"/></imageobject> <textobject><phrase>The context menu of a contact in the contact list</phrase></textobject> </mediaobject> </screenshot> <para> Hovering with the mouse over the name of a contact, brings up a tooltip with information about that contact. </para> <sect2 id="using-list-appearance"> <title>Setting your Appearance</title> <sect3 id="using-list-appearance-status"> <title>Changing your Status</title> <para> There are three ways to change your current status when you are connected to the &Windows; Live Messenger Service. The first is to use the dropdown menu in the main &kapp; window. The second way is to change the status with <menuchoice><guimenu>Connect</guimenu> <guimenuitem>My Status</guimenuitem></menuchoice> from the main &kapp; window. The third is to click with the &RMB; on the &kapp; tray icon, then click <menuchoice><guimenuitem>My Status</guimenuitem></menuchoice>. You can select from the following different states: </para> <itemizedlist> <listitem><para> Online </para></listitem> <listitem><para> Away </para></listitem> <listitem><para> Away with Auto-Reply </para></listitem> <listitem><para> Idle </para></listitem> <listitem><para> Be Right Back </para></listitem> <listitem><para> Busy </para></listitem> <listitem><para> Out to Lunch </para></listitem> <listitem><para> On the Phone </para></listitem> <listitem><para> Invisible </para></listitem> </itemizedlist> <screenshot> <screeninfo>The status context menu</screeninfo> <mediaobject> <imageobject><imagedata fileref="contactlist-states.png" format="PNG"/></imageobject> <textobject><phrase>The status context menu</phrase></textobject> </mediaobject> </screenshot> <para> The last item of the menu allows you to disconnect from the Live service. </para> <para> &kapp; differentiates between two <quote>Away</quote> states: </para> <itemizedlist> <listitem><para> The standard <quote>Away</quote> status which is the one you may be familiar with from other Instant Messenging clients. </para></listitem> <listitem><para> When you set your status to <quote>Away with Auto-Reply</quote>, a window appears where you can type in an automatic away message. This message will be sent automatically to every person who starts a chat with you. </para></listitem> </itemizedlist> <para> By default, &kapp; switches your status to <quote>Idle</quote> after 5 minutes of inactivity. This setting can be changed or disabled in the <menuchoice><guimenu>Account</guimenu> <guimenuitem>Status Options</guimenuitem></menuchoice> section of the Account Settings. </para> </sect3> </sect2> <sect2 id="using-chat"> <title>Starting Chat Conversations</title> <sect3 id="using-chat-single"> <title>Starting a Chat with a Contact</title> <para> Click with the &LMB; on an available contact in the contact list, or choose <guimenuitem>Chat</guimenuitem> from its context menu, accessible by clicking with the &RMB; on the contact. The chat window will open and you can start chatting with the contact. </para> </sect3> <sect3 id="using-chat-multiple"> <title>Starting a Chat with Multiple Participants</title> <para> Open a chat with a contact as described in <xref linkend="using-chat-single"/>. In the opened chat window, go to <menuchoice><guimenu>Chat</guimenu> <guimenuitem>Invite...</guimenuitem></menuchoice>. A window will appear, showing all available contacts. On the left, you can click on the contacts you want to add to the chat. Then click the <guibutton>right arrow icon button</guibutton>. On the right you will then see the contacts who are going to be invited. To remove some from there, select them, and click the <guibutton>left arrow icon button</guibutton>. You can also invite contacts that are not on your contact list, by directly entering their email address in the field on the left and clicking the <guibutton>add button</guibutton>. </para> </sect3> </sect2> <sect2 id="contactlist-contacts"> <title>Managing Contacts</title> <sect3 id="contactlist-contacts-add"> <title>Adding a Contact</title> <para> Use the menu <menuchoice><guimenu>Actions</guimenu> <guimenuitem>New Contact...</guimenuitem></menuchoice>. A dialog will appear, where you can enter the email address of the contact you wish to add. Optionally, you can also add the new contact directly to one or more groups, by enabling the checkboxes of the desired groups in the list. After clicking on <guibutton>OK</guibutton>, the contact will be added to your contact list. </para> </sect3> <sect3 id="contactlist-contacts-remove"> <title>Removing a Contact</title> <para> On the contact list, click with the &RMB; on the contact you would like to remove. Choose <menuchoice><guimenuitem>Delete Contact</guimenuitem></menuchoice> from the context menu. A dialog will open, where you can select to either: </para> <itemizedlist> <listitem><para> Remove the contact but still allow him or her to see your status. </para></listitem> <listitem><para> Remove and block the contact, to disallow him or her from either talking to you, or even seeing your online status. </para></listitem> </itemizedlist> <para> After clicking on <guibutton>OK</guibutton>, either option will cause the contact to disappear from your contact list. </para> </sect3> <sect3 id="contactlist-contacts-block"> <title>Blocking a Contact</title> <para> On the contact list, click with the &RMB; on the contact you would like to block. Choose <menuchoice><guimenuitem>Block Contact</guimenuitem></menuchoice> from the context menu. The contact will no longer be able to initiate a chat conversation with you or see your online status. You can still see that contact's online status and you can still initiate a chat if you want to. </para> </sect3> <sect3 id="contactlist-contacts-unblock"> <title>Unblocking a Contact</title> <para> On the contact list, click with the &RMB; on the contact you would like to unblock. Choose <menuchoice><guimenuitem>Unblock Contact</guimenuitem></menuchoice> from the context menu. The contact will be unblocked. </para> </sect3> <sect3 id="contactlist-contacts-copy"> <title>Copying a Contact to Another Group</title> <para> On the contact list, click with the &RMB; on the contact you would like to copy to another group. Choose <menuchoice><guimenuitem>Copy to Group</guimenuitem></menuchoice> and then, from the popup menu which appears, choose the group where you would like to copy the contact to. The contact is then copied to the chosen group. </para> </sect3> <sect3 id="contactlist-contacts-move"> <title>Moving a Contact to Another Group</title> <para> On the contact list, click with the &RMB; on the contact you would like to move to another group. Choose <menuchoice><guimenuitem>Move to Group</guimenuitem></menuchoice> and then, from the popup menu which appears, choose the group where you would like to move the contact to. The contact is then moved to the chosen group. </para> </sect3> <sect3 id="contactlist-contacts-rename"> <title>Renaming Contacts</title> <para> Contacts can be renamed from the properties dialog. This makes it possible, for example, to replace the long annoying name of a contact with a short descriptive name. For more details, see <xref linkend="settings-contact"/>. </para> </sect3> <sect3 id="contactlist-contacts-remove-from-group"> <title>Removing a Contact from a Group</title> <para> On the contact list, click with the &RMB; on the contact you would like to remove from a group. Choose <menuchoice><guimenuitem>Remove From Group</guimenuitem></menuchoice>. The contact is then removed from the group. </para> <para> If the contact is not present in any of your groups, &kapp; will automatically place him or her in a special group called <quote>Individuals</quote>. </para> </sect3> </sect2> <sect2 id="contactlist-groups"> <title>Managing Groups</title> <sect3 id="contactlist-groups-add"> <title>Adding a Group</title> <para> Use the menu <menuchoice><guimenu>Actions</guimenu> <guimenuitem>New Group...</guimenuitem></menuchoice>. A window appears, where you can enter a name for the new group. Confirm your choice by clicking <guibutton>OK</guibutton>. The new group will be added to your contact list. </para> </sect3> <sect3 id="contactlist-groups-rename"> <title>Rename a Group</title> <para> On the contact list, click with the &RMB; on the name of the group you would like to rename. Choose <menuchoice> <guimenu>Rename Group</guimenu> </menuchoice> from the context menu. You will now be asked for a new name for the group. After confirming the action by clicking <guibutton>OK</guibutton>, the group will be renamed. </para> </sect3> <sect3 id="contactlist-groups-remove"> <title>Removing a Group</title> <para> Make sure that the group you want to remove is empty and has no contacts in it. If the group is not empty, you will first need to remove all contacts from the group, before you can actually remove the group. On the contact list, click with the &RMB; on the name of the group you would like to remove. Choose <menuchoice><guimenu>Remove Group</guimenu></menuchoice> from the context menu. You will need to confirm the action, by clicking on <guibutton>Remove</guibutton>. </para> </sect3> </sect2> <sect2 id="contactlist-display"> <title>Changing the Contact List Appearance</title> <sect3 id="contactlist-display-grouping"> <title>Sorting Contacts</title> <para> Use the menu <menuchoice><guimenu>View</guimenu> <guimenuitem>Sort Contacts by</guimenuitem></menuchoice>. There are three different sorting modes available: </para> <variablelist> <varlistentry> <term>Group</term> <listitem><para> Your contacts will be each placed in the groups they belong to. </para></listitem> </varlistentry> <varlistentry> <term>Online/Offline</term> <listitem><para> The contact list will only show the <quote>Online</quote> and the <quote>Offline</quote> groups, and your contacts will be shown in one or the other, depending if they are online or not. </para></listitem> </varlistentry> <varlistentry> <term>Mixed</term> <listitem><para> This will make the contact list to display all available contacts in their respective groups, like with the <quote>Group</quote>. Unlike it however, all contacts who are currently offline will only appear in the Offline group. </para></listitem> </varlistentry> </variablelist> </sect3> <sect3 id="contactslist-display-showallowed"> <title>Show Allowed Contacts</title> <para> This option is available by using the menu option: <menuchoice><guimenu>View</guimenu> <guimenuitem>Show Allowed Contacts</guimenuitem></menuchoice>. When enabled, it adds an additional group to your contact list, named <quote>Allowed</quote>. It contains all contacts that you have allowed to see your online status and start chats with you, but that you did not add to your contact list. Contacts can only be removed entirely from the <quote>Allowed</quote> group if they no longer have you listed in their contact list. </para> </sect3> <sect3 id="contactslist-display-showremoved"> <title>Show Removed Contacts</title> <para> This option is available by using the menu option: <menuchoice><guimenu>View</guimenu> <guimenuitem>Show Removed Contacts</guimenuitem></menuchoice>. When enabled, it adds an additional group to your contact list, named <quote>Removed</quote>. It contains all the known removed contacts, who are contacts that you removed from your contact list. </para> </sect3> </sect2> <sect2 id="contactlist-other"> <title>Other Actions in the Contact List Window</title> <sect3 id="contactlist-other-personalmessage"> <title>Changing your own Personal Message</title> <para> &kapp; supports &Windows; Live Messengers Personal Message feature: under the displayed friendly name in the contact list window, you will see the text: <quote><Enter your personal message here></quote>. Click it, and you will be able to enter a personal message. To confirm your changes, press Enter or click somewhere else on the window. If you want to no longer display a personal message, just clean up the text field. </para> </sect3> <sect3 id="contactlist-other-sendmail"> <title>Send an Email to a Contact Using your Live Mail Account</title> <para> On the contact list, click with the &RMB; on the name of the contact you would like to send a mail to. Choose <menuchoice> <guimenu>Send Email</guimenu> </menuchoice> from the context menu. &kapp; will open your Live Mail Account in your favorite web browser, direct at the <quote>Compose</quote> page. </para> <para> This feature is also easily accessable while you chat with a contact. Click on the contact's picture in the Contacts Panel and then choose <menuchoice> <guimenu>Send Email</guimenu> </menuchoice> from the context menu. To read more about the Contacts Panel, see <xref linkend="using-chat-panels"/>. </para> </sect3> <sect3 id="contactlist-other-showprofile"> <title>See the Live Profile of a Contact</title> <para> On the contact list, click with the &RMB; on the name of the contact you would like to see the profile of. Choose <menuchoice> <guimenu>View Profile</guimenu> </menuchoice> from the context menu. &kapp; will open, in your favorite web browser, the profile page of the chosen contact. You can also do this while in chat with a contact. Click on the contact's picture in the Contacts Panel and then choose <menuchoice> <guimenu>View Profile</guimenu> </menuchoice> from the context menu. To read more about the Contacts Panel and how to open it, see <xref linkend="using-chat-panels"/>. </para> </sect3> <sect3 id="contactlist-other-showmyprofile"> <title>Viewing your Personal Live Profile</title> <para> Go to <menuchoice> <guimenu>Connect</guimenu> <guimenuitem>Show My Profile</guimenuitem></menuchoice>. &kapp; will then open your personal Live Profile in your favorite web browser. </para> </sect3> <sect3 id="contactlist-other-hotmail"> <title>Open your Live Mail Inbox Using &kapp;</title> <para> This option is only available if your email address has been created with Hotmail or &Windows; Live. </para> <para> The contact list window displays a link to your Live Mail account. The link states how many unread email messages you have. Clicking on this information will open your Live Mail Inbox in your preferred web browser. </para> <para> To enable or disable this option, see <xref linkend="settings-account-contactlist"/>. </para> </sect3> </sect2> </sect1> <sect1 id="using-chat-windows"> <title>Using the Chat Windows</title> <para> The Chat window is the place where your conversations happen. You can chat with one or more contacts together in a single chat window: for more details, see <xref linkend="using-chat-single"/> and <xref linkend="using-chat-multiple"/>. </para> <para> By default, &kapp; will display all your chats within a single window, each one within a tab: you can learn more about this behavior in <xref linkend="using-chat-tabs"/>. </para> <screenshot> <screeninfo>The &kapp; chat window</screeninfo> <mediaobject> <imageobject><imagedata fileref="chatwindow.png" format="PNG"/></imageobject> <textobject><phrase>The &kapp; chat window</phrase></textobject> </mediaobject> </screenshot> <sect2 id="using-chat-chatting"> <title>Chatting</title> <para> Once you have a chat window open, either opened by you or by a contact who has started a conversation with you, the chat can begin. Arrived messages are visible in the big upper area of the window, and you can type in your own messages in the smaller area on the bottom of the window. </para> <para> When you are done writing a message, you can press &Enter; to instantly send it, or click the <guibutton>Send</guibutton> button at the bottom right of the message editing area. </para> <para> To insert a new line in your message, press <keycap>Shift+Enter</keycap> or click the <guibutton>New line</guibutton> button at the bottom right of the message editing area. </para> <para> On the right side of the window, you will see the Contacts Panel, present by default. To learn more about the panels, see <xref linkend="using-chat-panels" />. </para> <para> Near the top, below the toolbar, you will find the Tab Bar, which lists a box for each chat currently active. New chats opened by your contacts will appear there. To learn more about the tabs, see <xref linkend="using-chat-tabs" />. </para> <para> You can define shortcuts for all the actions you can perform in chat. You can go to <guimenuitem>Settings</guimenuitem> <guimenuitem>Configure Shortcuts...</guimenuitem> to define them. Many actions already have default shortcuts, some of which are similar to those of Live Messenger. A couple handy shortcut worth mentioning are: &Esc;, which closes the chat window; <keycap>Alt+Z</keycap>, to send a nudge, and <keycap>Ctrl+Up</keycap> and its counterpart <keycap>Ctrl+Down</keycap>, which allow you to easily scroll through the past chat messages and read what has been written previously. </para> </sect2> <sect2 id="using-chat-emoticons-standard"> <title>Emoticons</title> <para> &kapp; comes with the default emoticons theme made by David Vignoni. </para> <screenshot> <screeninfo>The default &kapp; Emoticons</screeninfo> <mediaobject> <imageobject><imagedata fileref="chatwindow-emoticons.png" format="PNG"/></imageobject> <textobject><phrase>The default &kapp; Emoticons</phrase></textobject> </mediaobject> </screenshot> <para> Below the message editing area you can find a button with a smilie. By clicking this button, the message editing area will change, displaying all the available emoticons from the emoticon theme which is currently selected. Clicking on one of the shown emoticons will return to the normal message editing area, inserting the clicked emoticon in your current message. Sending the message will then display the emoticon in the chat. </para> <para> You can also enable a separate Panel to always keep your emoticons at hand. To learn more about the panels, see <xref linkend="using-chat-panels" />. </para> </sect2> <sect2 id="using-chat-emoticons-custom"> <title>Custom Emoticons</title> <para> &kapp; can send your own created emoticons to your friends, and receive theirs. </para> <para> To use them click - below the message editing area - at the button with the purple smilie. The message editing area will change, displaying all the available custom emoticons. Clicking on one of the shown emoticons will return to the normal message editing area, inserting the clicked emoticon in your current message. Sending the message will then display the emoticon in the chat. Your contact will receive and see it shortly. </para> <para> You can also enable a separate Panel to always keep your custom emoticons at hand. To learn more about the panels, see <xref linkend="using-chat-panels" />. </para> <para> When you use &kapp; for the first time or create a new account, the list will be empty. But adding new ones is easy! You can do it in two ways: </para> <itemizedlist> <listitem><para>Save the emoticons you received from contacts</para></listitem> <listitem><para>Add emoticons by choosing images from your computer</para></listitem> </itemizedlist> <para> When a contact you are chatting with sends you a custom emoticon, you can click on it to save it to your own custom emoticons. A dialog window will pop up: </para> <screenshot> <screeninfo>The Add Custom Emoticon dialog</screeninfo> <mediaobject> <imageobject><imagedata fileref="chatwindow-custom-emoticons-add.png" format="PNG"/></imageobject> <textobject><phrase>The Add Custom Emoticon dialog</phrase></textobject> </mediaobject> </screenshot> <para> You may also use this dialog to can change the text shortcut associated with the new emoticon. By clicking the <guibutton>Ok</guibutton> button, the new emoticon will instantly be available. </para> <para> Alternatively, you can manage your emoticons from the Account Settings dialog. To learn more about the Account Settings, see <xref linkend="settings-account-emoticons" />. </para> </sect2> <sect2 id="using-chat-filetransfer"> <title>File Transfers</title> <para> &kapp; supports transferring files through MSN. To send a file to a contact, you first have to open a chat with him or her. </para> <para> Then you can send a file by choosing from the menu <menuchoice><guimenu>Chat</guimenu> <guimenuitem>Send File</guimenuitem></menuchoice>. Choose the file you want to send to the contact. Confirm the action by clicking <guibutton>OK</guibutton>. Otherwise, you can click on the <guibutton>Send a File</guibutton> button, located on the chat toolbar. </para> <para> But by far, the easiest method to send one or more files to your contacts is drag and drop. Drag some files from the desktop or a directory in &dolphin; or &konqueror;, and drop them at the chat messages view, or message editing area. The files will be sent immediately. </para> <para> After your contact accepts the file transfer, the &kapp; file Transfer Window will appear and the file transfer will start. </para> <para> Please note that Live Messenger does not allow to its users to accept more than five file transfers at once for each contact. </para> <para> Additionally, that there could be problems if you are behind a router or a NAT. Currently it is required to manually open the TCP ports 6891-6900 in your firewall. The port range can be changed from the settings panel, see <xref linkend="settings-kmess-settings" />. If you're behind a NAT router, you also need to make sure these ports are also forwarded to your local computer. </para> </sect2> <sect2 id="using-chat-panels"> <title>Panels</title> <para> The panels are movable and closeable areas of the chat window, where additional information and other useful things are displayed. Currently &kapp; provides the following panels: </para> <itemizedlist> <listitem><para>Contacts</para></listitem> <listitem><para>Emoticons</para></listitem> <listitem><para>Custom emoticons</para></listitem> </itemizedlist> <para> The <quote>Emoticons</quote> and <quote>Custom emoticons</quote> panels can also be displayed as buttons below the message editing area. </para> <screenshot> <screeninfo>Chat window with the contacts panel (on the right side)</screeninfo> <mediaobject> <imageobject><imagedata fileref="chatwindow.png" format="PNG"/></imageobject> <textobject><phrase>Chat window with the contacts panel (on the right side)</phrase></textobject> </mediaobject> </screenshot> <para> The panels can be moved wherever you like: just click and hold the &LMB; on the panel title, then move them around: they will stick on the chat window borders. When a panel is placed on the top or bottom border, rather than the left or right side, its behavior will be different. For example, the contacts panel when at the top or bottom will only show the contact names, status and personal message of the chat participants. </para> <para> If you do not like a panel, you can click on the little <quote>X</quote> button near the panel name, or you can do it from the menu: <menuchoice><guimenuitem>View</guimenuitem> <guimenuitem>Panels</guimenuitem></menuchoice> then choose the panel to hide. </para> <sect3 id="using-chat-panels-contacts"> <title>Contacts Panel</title> <para> The contacts panel provides you with information and functions associated with each contact who is participating to the chat. Information includes: </para> <itemizedlist> <listitem><para>Display picture</para></listitem> <listitem><para>Email address (by clicking on the display picture)</para></listitem> <listitem><para>Contact status</para></listitem> <listitem><para>Personal message</para></listitem> </itemizedlist> <para> Click with the &LMB; or &RMB; on the display picture of a contact in the contacts panel, to bring up a context menu with even more operations: </para> <screenshot> <screeninfo>A contact's context menu</screeninfo> <mediaobject> <imageobject><imagedata fileref="chatwindow-contextmenu.png" format="PNG"/></imageobject> <textobject><phrase>A contact's context menu</phrase></textobject> </mediaobject> </screenshot> <para> The contacts panel has some additional features: when the person is writing a message, his or her display picture becomes brighter. If you would like to see your own display picture more than just those of your contacts, you can enable the account settings option <guilabel>Display your own display picture in the chat window</guilabel>. Clicking your display picture there will bring up the account settings. To learn more about how to enable this option, see <xref linkend="settings-account-chat-behavior"/>. </para> <para> Contacts panel adjusts its layout when it is placed at top or bottom of the chat window. For example, it will not display the pictures for contacts, nor the picture of your account. </para> </sect3> <sect3 id="using-chat-panels-emoticons"> <title>Emoticons Panels</title> <para> There are two emoticon panels: the <quote>emoticons panel</quote> and the <quote>custom emoticons panel</quote>. The only difference between them is that the first one shows the default emoticons (which are like the standard MSN emoticons but with the &kapp; style), and the second one shows the custom emoticons you currently have. </para> <para> The emoticon panels also have a small preview area, which will show a bigger animated version of the emoticon you hover your mouse cursor on. </para> </sect3> </sect2> <sect2 id="using-chat-nudges"> <title>Nudges</title> <para> &kapp; can send and receive nudges, just like &Windows; Live Messenger. They are a good way to require attention from your contacts, but may also annoy them. </para> <para> To send a nudge, you can either click on the <guibutton>Nudge</guibutton> toolbar icon, or select <menuchoice> <guimenu>Chat</guimenu> <guimenuitem>Send a Nudge!</guimenuitem></menuchoice>. Sending a nudge will cause your chat window to shake momentarily. Your contact will receive the nudge in the same way. His or her chat window will shake and they will also hear a sound as if they have received a message. </para> <para> Unlike &Windows; Live Messenger, &kapp; does not limit the number of nudges you can send or receive every minute. Try not to abuse this, as it is easy to make someone angry just by using them a bit too much. If you do not like the shake effect nudges cause, you can disable this in the account settings; see <xref linkend="settings-account-chat"/>. </para> </sect2> <sect2 id="using-chat-zooming"> <title>Zooming</title> <para> You may find that the text in your chat window is too small or too big. Use the menu items <menuchoice><guimenu>View</guimenu> <guimenuitem>Zoom In</guimenuitem></menuchoice> and <menuchoice><guimenu>View</guimenu> <guimenuitem>Zoom Out</guimenuitem></menuchoice>, to increase or decrease the font size displayed in the chats. </para> </sect2> <sect2 id="using-chat-save"> <title>Save Chat Sessions</title> <para> To save an active chat session to a file, you can click on <menuchoice><guimenu>Chat</guimenu> <guimenuitem>Save Chat...</guimenuitem></menuchoice> in the chat window menu. Choose the directory where the chat should be saved and name the file. Save the chat now by clicking <guibutton>OK</guibutton>. Also see <xref linkend="settings-account-logging"/>. </para> </sect2> </sect1> <sect1 id="using-chat-history"> <title>Using Chat History</title> <para> If chat logging is enabled the Chat History dialog will display all of your saved chats with your contacts. You can select which contact's chat history to view and then you can choose to filter the saved chats. Filtering allows you to select a specific chat to view, or, you can view all chats that occurred between two dates. </para> <para> To access the chat history dialog you can: <itemizedlist> <listitem><para>Click with the &RMB; on a contact in the contact list and choose <menuchoice> <guimenu>Show Chat History...</guimenu> </menuchoice>, or,</para></listitem> <listitem><para>Choose <menuchoice> <guimenu>Actions</guimenu> <guimenuitem>Show Chat History...</guimenuitem> </menuchoice> from the contact list window.</para></listitem> </itemizedlist> </para> <para> Note: Chat logging is not enabled by default; see <xref linkend="settings-account-logging" /> for information on enabling it. </para> <screenshot> <screeninfo>The &kapp; chat history dialog</screeninfo> <mediaobject> <imageobject><imagedata fileref="chathistorydialog.png" format="PNG" /></imageobject> <textobject><phrase>The &kapp; chat history dialog</phrase></textobject> </mediaobject> </screenshot> </sect1> <sect1 id="using-export-list"> <title>Exporting your Contact List</title> <para> Occasionally it is helpful to export your contact list. &kapp; supports export of your contact list into either CSV or XML format. </para> <para> Choose <menuchoice><guimenu>Actions</guimenu><guimenuitem>Export Contact List...</guimenuitem></menuchoice> from the contact list window to open the Export dialog. </para> <para> From this dialog you can choose which contacts you wish to export (the default is all contacts) as well as the pieces of data you wish to export. &kapp; allows to export three pieces of data: The contact handle, their friendly name, and their current personal message. </para> <para> Finally, select which filetype to export to and choose <guibutton>Export...</guibutton>. </para> <screenshot> <screeninfo>The &kapp; export contact list dialog</screeninfo> <mediaobject> <imageobject><imagedata fileref="exportlist-dialog.png" format="PNG" /></imageobject> <textobject><phrase>The &kapp; export contact list dialog</phrase></textobject> </mediaobject> </screenshot> </sect1> </chapter> <chapter id="configuring-kapp"> <title>Configuring &kapp;</title> <para> &kapp; can be customized as you wish. The settings of &kapp; are organized in the following groups: </para> <itemizedlist> <listitem><para>Global settings (⪚ which web browser to use).</para></listitem> <listitem><para>Personal settings for every account (⪚ your name, and picture).</para></listitem> <listitem><para>Settings for a specific contact (⪚ a setting a contact alias).</para></listitem> </itemizedlist> <para> The account settings dialog should cover most of your needs to personalize your account. You can also personalize many details about your contacts with the contact settings, and change many application-wide settings, like the favorite browser &kapp; will use, from the Configure &kapp; dialog. </para> <para> To learn more about the account settings, see <xref linkend="settings-account"/>. To learn more about the contact settings, see <xref linkend="settings-contact"/>. To learn more about the <quote>configure &kapp; dialog</quote>, see <xref linkend="settings-kmess"/>. </para> <sect1 id="settings-contact"> <title>The Contact properties Dialog</title> <para> On the contact list, click with the &RMB; on the contact you would like to customize. Choose <menuchoice><guimenuitem>Properties</guimenuitem></menuchoice> and the contact properties dialog will appear. </para> <screenshot> <screeninfo>The Contact Settings dialog</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-contact.png" format="PNG"/></imageobject> <textobject><phrase>The Contact Settings dialog</phrase></textobject> </mediaobject> </screenshot> <para> The first tab allows you at one glance to see some information about the contact. It also contains some useful options: by just checking or unchecking the group names within the list at the middle, you can move the contact around the available groups. You can change the display picture of the contact with one of your own. To do this, just click on the display picture of your contact. You will be asked to choose a picture file. The image you choose here will be used instead of the picture set by the contact. </para> <para> Below, a checkbox allows you to enter a custom name for the contact, which will be used instead of the name used by the contact. You can also choose to disable notifications for a contact. This is useful, for example, if that person connects and disconnects from MSN very rapidly and you keep seeing notification popups about that contact. Uncheck the box <guilabel>Disable notifications for this contact</guilabel>. &kapp; also allows the user to choose a particular sound to be played when the contact comes online or goes offline. </para> <para> The second tab, <quote>Display Pictures</quote>, contains a list of all display pictures the contact has used. By clicking on <guilabel>Clear Cache</guilabel> you can delete the display pictures. You can also <quote>steal</quote> a display picture from the contact, using it as your own, by clicking on <guilabel>Use As Display Picture</guilabel>. </para> <para> The third tab, <quote>Notes</quote>, allows you to keep some annotations about the contact. You can also access these notes directly from the contacts panel of the chat window. To learn more about the contacts panel, see <xref linkend="using-chat-panels-contacts" />. </para> <para> The fourth tab, <quote>Emoticons</quote>, allows you to restore previously hidden emoticons from that contact. Just select the entry you want to restore and click on <guilabel>Restore</guilabel>. </para> </sect1> <sect1 id="settings-account"> <title>The Settings Dialog</title> <para> The settings dialog allows to customize your account settings and personalize your account. Settings are divided in pages, accessible with the icons on the left area. Each page represents a different aspect of your account. </para> <para> You can open this dialog from your contact list window, via the menu: <menuchoice><guimenu>Actions</guimenu> <guimenuitem>Configure Account...</guimenuitem></menuchoice>, or from the tray icon, clicking with the &RMB; on the &kapp; tray icon, then clicking <menuchoice><guimenuitem>Configure Account...</guimenuitem></menuchoice>. </para> <sect2 id="settings-account-account"> <title>Account Page</title> <para> From this page you can manage the most important details of your MSN account. </para> <screenshot> <screeninfo>Account Settings Dialog - The Account page</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account.png" format="PNG"/></imageobject> <textobject><phrase>Account Settings Dialog - The Account page</phrase></textobject> </mediaobject> </screenshot> <para> The friendly name field contains the name that your contacts will see in their contact lists. You cannot change it if your account is not verified with Passport (see <xref linkend="login-create-account"/> for more details). You also cannot change it unless you are currently connected with that account. </para> <para> You can change the email address of your account, in case you have changed your MSN address. This makes sure youre preferences are not lost. </para> <para> The password field is usually blank. If you wish that &kapp; remembers your password, you can enter it here and check the checkbox next to <guilabel>Remember password</guilabel>. </para> <para> Your display picture can be easily changed by clicking on the <guibutton>Change...</guibutton> button. A menu with three options will appear: </para> <variablelist> <varlistentry> <term>Browse...</term> <listitem><para> Use this option to select an image from your computer. The picture will be automatically scaled to the mandatory size of 96x96 pixels. </para></listitem> </varlistentry> <varlistentry> <term>Browse and Crop Picture...</term> <listitem><para> Use this option to select an image from your computer and crop it yourself. This allows you to select a certain part of an image and use it as your display picture. Drag a square on the image preview to specify which part you want to use. The selected part will be highlighted and the part about to be discarded will be darkened. When you have found which part of the image you want to use, click <guibutton>OK</guibutton>, and &kapp; will resize it and set is as your display picture automatically. </para></listitem> </varlistentry> <varlistentry> <term>Set Previous Image...</term> <listitem><para> Use this option if you want to choose a display picture you previously already had used. </para></listitem> </varlistentry> </variablelist> <para> Below the button, the <quote>Do not use</quote> checkbox allows you to not use any display picture at all. </para> <para> The <guilabel>Log in with this account automatically</guilabel> checkbox, when enabled, causes &kapp; to automatically connect to MSN with this account every time the application is started. Choosing an MSN status from the <guibutton>Login as</guibutton> dropdown list, will make &kapp; set that status everytime you login to the &Windows; Live Messenger service. </para> <para> The second tab, <guilabel>Status Options</guilabel>, contains some status-related options. The <guilabel>Change status to Idle when inactive</guilabel> checkbox causes &kapp; to change your status from <quote>Online</quote> to <quote>Idle</quote> whenever you you do nothing for some time, which defaults to 5 minutes. You can change this period from the spin box below the checkbox. </para> <para> The <guilabel>Disable notifications when your status is set to Busy</guilabel> checkbox will prevent all contact status and message notifications from disturbing you if your status is set to <quote>Busy</quote>. </para> </sect2> <sect2 id="settings-account-contactlist"> <title>Contact List Page</title> <screenshot> <screeninfo>Account settings dialog - The contact list page</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-contactlist.png" format="PNG"/></imageobject> <textobject><phrase>Account settings dialog - The contact list page</phrase></textobject> </mediaobject> </screenshot> <para> This page contains some options which affect the contact list window. </para> <para> The <guilabel>Display a count of unread email</guilabel> checkbox will show a link to your Live Mail inbox, showing how many unread email you have. This however, will only be used if your email account was created with the Live service. </para> <para> Live Messenger is able to show your contacts the music you are listening to. Unlike WLM, which only notifies them about what is playing in &Windows; Media Player, &kapp; will discover which media player you are using and automatically show your friends the details of the tracks you are listening to. Enable the <guilabel>Show contacts which song I am listening to</guilabel> checkbox to activate this feature. When you listen to music, &kapp; will show the track name in the upper part of your contact list. &kapp; supports a wide range of media players: all players supporting the <acronym>MPRIS</acronym> specification are automatically supported. The following list shows some of the currently supported players: </para> <itemizedlist> <listitem><para>amaroK 1.x</para></listitem> <listitem><para>&amarok; 2</para></listitem> <listitem><para>Audacious</para></listitem> <listitem><para>BMPx</para></listitem> <listitem><para>Dragon Player</para></listitem> <listitem><para>&juk;</para></listitem> <listitem><para>Kaffeine</para></listitem> <listitem><para>&kscd;</para></listitem> <listitem><para>Qmmp</para></listitem> <listitem><para>VLC Media Player</para></listitem> <listitem><para>XMMS2</para></listitem> </itemizedlist> <para> Disabling the option <guilabel>Show background image</guilabel> removes the &kapp; logo, the hummingbird, from the contact list background. <!-- This option may seem superfluous, but we have received an impressive amount of requests for it! --> </para> <para> The next two options affect how the friendly names of your contacts will be displayed. The <guilabel> Enable "Messenger Plus!" formatting</guilabel> checkbox will show the colors and text formatting used by your contacts in their friendly names and personal messages. By default, this option is turned off: all the formatting is by default stripped out from the names, to improve the readability of the contact list. The checkbox named <guilabel>Show the email address of contacts instead of their friendly name</guilabel> does just that, if you prefer seeing the email address of your contacts instead of their friendly name, you can enable it. </para> </sect2> <sect2 id="settings-account-emoticons"> <title>Emoticons Page</title> <screenshot> <screeninfo>Account settings dialog - The emoticons page, emoticon themes tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-emoticons.png" format="PNG"/></imageobject> <textobject><phrase>Account settings dialog - The emoticons page, emoticon themes tab</phrase></textobject> </mediaobject> </screenshot> <para> &kapp; supports many different emoticon themes and can use those of other instant messaging applications, such as &kopete;. New themes can be downloaded by visiting the <ulink url="http://www.kde-look.org/index.php?xcontentmode=23">www.kde-look.org</ulink> site. </para> <para> The default &kapp; emoticon theme is named <quote>&kapp;-New</quote>, which contains the emoticons created by David Vignoni. </para> <para> Note that not every emoticon from an emoticon theme can be used by &kapp; currently. Instead of replacing all your emoticons and emoticon shortcuts, &kapp; uses the emoticon theme as overlay. All emoticon shortcuts remain identical and all emoticon images are replaced with the ones from the emoticon theme, which have the same shortcut. In other words, &kapp; looks if the emoticon theme has a new image for the <quote>:)</quote> shortcut, one for the <quote>:P</quote> shortcut, etc.. </para> <para> From the left tab, <guilabel>Emoticon Themes</guilabel>, you can choose which emoticon theme &kapp; will use to show the default MSN emoticon shortcuts, like <quote>:-)</quote> and <quote>:P</quote>. </para> <screenshot> <screeninfo>Account settings dialog - The emoticons page, custom emoticons tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-emoticons-custom.png" format="PNG"/></imageobject> <textobject><phrase>Account settings dialog - The emoticons page, custom emoticons tab</phrase></textobject> </mediaobject> </screenshot> <para> Besides MSN emoticon themes, &kapp; can also manage custom emoticons. Each account has its own set of custom emoticons. From this account settings page, you are able to browse, rename, create or delete the custom emoticons of your accounts. See the <xref linkend="using-chat-emoticons-custom"/> to learn more about their usage. </para> <para> Any item you see in the list is an emoticon, with the shortcut displayed below it. Select an item and click the <guibutton>Remove</guibutton> button to delete it. Click the <guibutton>Rename</guibutton> button, or directly click on an item, to change the shortcut for the selected emoticon. </para> <para> To create a new custom emoticon from an image on your computer, click on the <guibutton>Add New...</guibutton> button. A dialog window will pop up: </para> <screenshot> <screeninfo>The Add Custom Emoticon dialog</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-emoticons-custom-add.png" format="PNG"/></imageobject> <textobject><phrase>The Add Custom Emoticon dialog</phrase></textobject> </mediaobject> </screenshot> <para> Click the <guibutton>...</guibutton> button to select an image from your computer. You can also directly type or paste from the clipboard the path of the file, in the field next to the <guilabel>...</guilabel> button. If the image is valid, it will be displayed in the square on the top left corner of the dialog. Then choose a text shortcut to associate to the new emoticon. Finally, click the <guibutton>OK</guibutton> button to instantly add it to your custom emoticons theme. </para> <para> To save your changes to the theme, be sure to confirm them by clicking the <guibutton>OK</guibutton> or the <guibutton>Apply</guibutton> buttons. </para> </sect2> <sect2 id="settings-account-chat"> <title>Chatting Page</title> <para> This page customizes the appearance of your chat windows, and the formatting of chat messages. </para> <sect3 id="settings-account-chat-style"> <title>Chat Style</title> <screenshot> <screeninfo>Account Settings Dialog - The Chat page, Style tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-chat.png" format="PNG"/></imageobject> <textobject><phrase>Account Settings Dialog - The Chat page, Style tab</phrase></textobject> </mediaobject> </screenshot> <para> The first tab of this page contains many options to customize how the chats look like. &kapp; allows you to choose between various styles for your chat windows. To learn more about the available chat styles, see <xref linkend="settings-account-chat-styles"/>. </para> <para> You can choose the chat style between the available ones using the <guilabel>Chat style</guilabel> drop-down menu. If you want to try out new things, click the <guibutton>Get New Styles...</guibutton> button: you will be able to browse and download new chat styles in just a few seconds: just choose, click install, and your new styles will be available for you to try! </para> <para> Just below the style selection option, a box shows how chats will look like. At the bottom, a the options make it possible to further customize the chat looks. With the <guilabel>Show emoticons</guilabel> checkbox you can choose whether to show any emoticon in chat, or not. The <guilabel>Show winks</guilabel> checkbox allows you to hide received winks, which may be annoying. </para> <para> When the <guilabel>Group follow-up messages from the same contact</guilabel> checkbox is active, all messages sent by you or your contacts will be grouped together until another participant writes something. In many cases, this will save a lot of space and make the chat a lot more readable. </para> <para> The <guilabel>Show timestamp</guilabel> checkbox controls if the time of arrival or sending of messages is displayed. If it is enabled, you will also be able to show the seconds or the date when the message was sent or received, instead of just the hours and minutes. </para> <sect4 id="settings-account-chat-styles"> <title>Chat Styles</title> <para> &kapp; allows you to choose between various styles for your chat windows. The default theme is called 'Fresh', which displays the participants' pictures: </para> <screenshot> <screeninfo>The Fresh chat style</screeninfo> <mediaobject> <imageobject><imagedata fileref="styles-fresh.png" format="PNG"/></imageobject> <textobject><phrase>The Fresh chat style</phrase></textobject> </mediaobject> </screenshot> <para> Another style is <quote>Classic</quote>. This theme comes into two flavors, default and compact. The second lets &kapp; display the messages in a more compact fashion than the first. Take a look at the image below to see the difference: </para> <screenshot> <screeninfo>The Classic chat style</screeninfo> <mediaobject> <imageobject><imagedata fileref="styles-classic.png" format="PNG"/></imageobject> <textobject><phrase>The Classic chat style</phrase></textobject> </mediaobject> </screenshot> <screenshot> <screeninfo>The Classic-compact style</screeninfo> <mediaobject> <imageobject><imagedata fileref="styles-classic-compact.png" format="PNG"/></imageobject> <textobject><phrase>The Classic-compact style</phrase></textobject> </mediaobject> </screenshot> </sect4> </sect3> <sect3 id="settings-account-chat-text"> <title>Chat Text</title> <screenshot> <screeninfo>Account Settings Dialog - The Chatting page, Text tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-chat-text.png" format="PNG"/></imageobject> <textobject><phrase>Account Settings Dialog - The Chatting page, Text tab</phrase></textobject> </mediaobject> </screenshot> <para> The second tab of the settings page, Text, allows to define how the text in chats will be shown. </para> <para> To change how your own chat messages are formatted, use the controls below <guilabel>Your message font</guilabel>. The big button on the left allows you to change the used font and its attributes (like size, italics, bold) and will show a preview of your choice. Clicking the button on the right will change the font color. </para> <para> Sometimes your contacts use fonts or colors that you might not like or that are difficult to read: activating the <guilabel>Force messages from your contacts to use this font</guilabel>, and setting up the font setting controls below it, will display all the messages incoming from your contacts in the font and color of your choice. </para> <para> <guilabel>Use font effects in messages</guilabel> will enable font effects as often seen in IRC clients: Words surrounded by asterisks (⪚ *bold*) will be displayed with a bold font, those surrounded by forward slashes (⪚ /italics/) will be shown italicized, and those surrounded by underscores (⪚ _underline_) will be underlined. </para> <para> The last checkbox, <guilabel>Enable "Messenger Plus! formatting</guilabel>, will enable <quote>Messenger Plus!</quote> formattings to the sent and received messages. By default, this option is turned off: all the formatting is by default stripped out from the messages, to increase the readability of the chat messages and friendly names shown. </para> </sect3> <sect3 id="settings-account-chat-behavior"> <title>Chat Behavior</title> <screenshot> <screeninfo>Account Settings Dialog - The Chatting page, Behavior tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-chat-behavior.png" format="PNG"/></imageobject> <textobject><phrase>Account Settings Dialog - The Chatting page, Behavior tab</phrase></textobject> </mediaobject> </screenshot> <para> The third and last tab contains some options important to define how the chat windows will behave and will look like. </para> <para> To disable the graphical effects seen when receiving and sending nudges, you can disable the <guilabel>Shake the chat window when a nudge is received or sent</guilabel> checkbox. </para> <para> If <guilabel>Display your own display picture in the chat window</guilabel> checkbox is enabled, your own display picture will be displayed in the contacts panel, along with those of the contacts in that chat. To learn more about the contacts panel, see <xref linkend="using-chat-panels-contacts"/>. </para> <para> The last option of this page controls how your chats will be grouped together in windows or tabs. </para> <sect4 id="using-chat-tabs"> <title>Tabbed Chats</title> <para> Tabs are little labels at the top of your chat window, which allow you to keep many chats in the same window, as opposed to having one chat per window. Unlike &Windows; Live Messenger, which does not support this feature at all, &kapp; comes with tabbed chats enabled by default. </para> <para> Each tab in the chat window has a little close button on its label, to close it. You can also do it by using the <keycombo action="simul"><keysym>Ctrl</keysym><keysym>W</keysym></keycombo> shortcut. Clicking the window's close button will pop up a dialog box asking if you want to close all the open tabs. Of course, it will not be shown if there only is one tab in the chat window. </para> <para> If you have more than one tab in a chat window, you will be able to move them around by dragging and dropping them using the &MMB;. </para> <para> These are the available chat grouping options: </para> <variablelist> <varlistentry> <term>Always</term> <listitem><para> All your chats are grouped together in one chat window, separated by tabs. </para></listitem> </varlistentry> <varlistentry> <term>Never</term> <listitem><para> This option will mimic the &Windows; Live Messenger behavior of one window per chat. Tabs are never used. </para></listitem> </varlistentry> <varlistentry> <term>For contacts in the same group</term> <listitem><para> If you choose this option, &kapp; will use tabs for contacts in the same group. For example, suppose you have the <quote>Friends</quote> and <quote>Coworkers</quote> groups. If you chat with two friends, you will see the two chats as tabs in the same window: but if a coworker contacts you, her chat will be shown in another window. </para></listitem> </varlistentry> </variablelist> </sect4> </sect3> </sect2> <sect2 id="settings-account-logging"> <title>Chat Logging</title> <screenshot> <screeninfo>Account Settings Dialog - The Chat Logging page</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-account-logging.png" format="PNG"/></imageobject> <textobject><phrase>Account Settings Dialog - The Chat Logging page</phrase></textobject> </mediaobject> </screenshot> <para> &kapp; gives you the opportunity to automatically save all chats when they end (which means that a chat will be saved when you close its chat window or tab). </para> <para> Enable the <guilabel>Enable chat logging</guilabel> checkbox to have &kapp; save all chats. You will be able to look them up later in the <guimenu>Actions</guimenu> menu of the contact list window, or through the right click context menu of a contact. </para> <para> The chats logs are not readily available without having &kapp; open: if you want, you can have &kapp; save your chats also in a common format, to be able to access your chat logs even if &kapp; is not running. To do so, enable the <guilabel>Additionally save chats logs to file</guilabel> checkbox. </para> <para> You can choose the format to save the additional logs in by using the <guilabel>File format used for saving</guilabel> drop-down list. Normally you want to go for the <guilabel>Web Pages (&HTML;)</guilabel> option, because &HTML; pages show all emoticons and colors you and your contacts used. Please note that &HTML; chat logs that are opened on another computer, will not contain any emoticons and display pictures. With the other option, <guilabel>Plain Text</guilabel>, the saved files will only contain basic information displayed in an IRC-like fashion. </para> <para> You can also select how to separate and organize your additional chat log files: &kapp; will create nested directories named as the chat's date and time, based on which option you choose here. The choices are to organize by <guilabel>Year</guilabel>, by <guilabel>Year then Month</guilabel>, by <guilabel>Year, Month then Day</guilabel> or to <guilabel>Do not organize files</guilabel> at all. </para> <para> The organizing directory will be created, accordingly to your choice, within the directory you can choose at the bottom. After applying the settings, &kapp; will start to automatically saving all chats. </para> </sect2> </sect1> <sect1 id="settings-kmess"> <title>The &kapp; Settings Dialog</title> <para> The &kapp; configuration dialog allows to customize the general application behavior. It has been divided in pages, accessible by the icons on the left area of the window. </para> <para> You can open it from your Contact List window, via the menu: <menuchoice><guimenu>Actions</guimenu> <guimenuitem>Configure &kapp;...</guimenuitem></menuchoice>, or from the tray icon, clicking with the &RMB; on the &kapp; tray icon, then clicking <menuchoice><guimenuitem>Configure &kapp;...</guimenuitem></menuchoice>. </para> <sect2 id="settings-kmess-accounts"> <title>Accounts Page</title> <screenshot> <screeninfo>&kapp; Settings Dialog - The Accounts page</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-kmess-accounts.png" format="PNG"/></imageobject> <textobject><phrase>&kapp; Settings Dialog - The Accounts page</phrase></textobject> </mediaobject> </screenshot> <para> This page lists all the accounts known by &kapp;. All changes made in this page will be applied immediately, without you having to press the <guibutton>OK</guibutton> or the <guibutton>Apply</guibutton> buttons. </para> <para> By selecting an account from the list, you can choose to open the Account Settings dialog for that account with the <guibutton>Edit</guibutton> button, or remove it with the <guibutton>Remove</guibutton> button. In the latter case, you will be asked if you are sure you want to delete the account. </para> <para> Click on the <guibutton>Add New...</guibutton> button to create a new account: the Account Settings page will appear, to allow you to immediately change its details. </para> </sect2> <sect2 id="settings-kmess-notifications"> <title>Notifications Page</title> <screenshot> <screeninfo>&kapp; Settings Dialog - The Notifications page</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-kmess-notifications.png" format="PNG"/></imageobject> <textobject><phrase>&kapp; Settings Dialog - The Notifications page</phrase></textobject> </mediaobject> </screenshot> <para> From this page, you are able to configure how &kapp; notifies you about contacts who come online, new incoming messages, and also how it will show you informations and errors. </para> <para> The list shows the various event types supported by &kapp;, along with the current status of each event. The event status is a list of icons representing the various actions that will be taken when that event will occur. </para> <para> The following events are available: </para> <itemizedlist> <listitem><para>A contact has started a chat with you</para></listitem> <listitem><para>A contact has gone offline</para></listitem> <listitem><para>A contact has come online</para></listitem> <listitem><para>A contact has changed its MSN status</para></listitem> <listitem><para>You have received a new email</para></listitem> <listitem><para>You received a message from a contact</para></listitem> <listitem><para>A contact requires your attention</para></listitem> <listitem><para>Information on network and application status</para></listitem> </itemizedlist> <para> For each event, you can choose many actions to perform: </para> <variablelist> <varlistentry> <term>Play a sound</term> <listitem><para> A sound will be played: there are default sounds played for most actions, but you can change them with your favorite ones. The little <guibutton>Play</guibutton> button allows you to preview the selected sound. </para></listitem> </varlistentry> <varlistentry> <term>Show a message in a popup</term> <listitem><para> If this option is checked, a message will be shown within a passive notification. If you are using &kde; as your desktop, you will see a Plasma notification; otherwise, a notification box will appear near your &kapp; tray icon. </para></listitem> </varlistentry> <varlistentry> <term>Log to a file</term> <listitem><para> The event will be noted into a file of your choice. </para></listitem> </varlistentry> <varlistentry> <term>Mark taskbar entry</term> <listitem><para> The event will cause the corresponding window to be highlighted in your task bar. </para></listitem> </varlistentry> <varlistentry> <term>Run command</term> <listitem><para> When the event occurs, a shell command of your choice will be executed. </para></listitem> </varlistentry> </variablelist> </sect2> <sect2 id="settings-kmess-settings"> <title>Settings Page</title> <para> This page contains some generic settings of the application. </para> <sect3 id="settings-kmess-settings-web"> <title>Web Browser</title> <screenshot> <screeninfo>&kapp; Settings Dialog - The Settings page, Web Browser tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-kmess-settings-web.png" format="PNG"/></imageobject> <textobject><phrase>&kapp; Settings Dialog - The Settings page, Web Browser tab</phrase></textobject> </mediaobject> </screenshot> <para> Here you can define which web browser will be invoked by &kapp; when you open your webmail or click on a link in chat. &kapp; provides the option to use a custom web browser instead of the &kde; default one (which is &konqueror;, usually). </para> <para> To use for example Firefox instead of the &kde; default browser, change the radiobutton from <guilabel>Use the &kde; default browser</guilabel> to <guilabel>Use an installed browser:</guilabel> and choose the one you want to use from the drop-down list. </para> <para> Additionally, &kapp; allows you to run your own browser, if it is not present in the aforementioned list. Select the <guilabel>Specify a custom command</guilabel> radiobutton and enter the path or the name of the browser. To specify the &URL; that the browser should open, add <quote>%u</quote> to the parameters. </para> </sect3> <sect3 id="settings-kmess-settings-email"> <title>Email Client</title> <screenshot> <screeninfo>&kapp; Settings Dialog - The Settings page, Email Client tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-kmess-settings-email.png" format="PNG"/></imageobject> <textobject><phrase>&kapp; Settings Dialog - The Settings page, Email Client tab</phrase></textobject> </mediaobject> </screenshot> <para> Here you can define which email client will be invoked by &kapp; when you want to send mail on a non-Live account. If you are using a Live account, you can choose to open the Live Mail website instead of your email client, by enabling the <guilabel>Use Live Mail if the account supports it</guilabel> checkbox. </para> <para> To use Thunderbird for example instead of the &kde; default email client, change the radiobutton from <guilabel>Use the &kde; default email client</guilabel> to <guilabel>Use an installed email client:</guilabel> and choose the one you want to use from the drop-down list. </para> <para> Additionally, &kapp; allows you to run your own browser, if it is not present in the aforementioned list. Select the <guilabel>Specify a custom command</guilabel> radiobutton and enter the path or the name of the browser. To specify the &URL; that the browser should open, add <quote>%u</quote> to the parameters. </para> </sect3> <sect3 id="settings-kmess-settings-filetransfers"> <title>File Transfers</title> <screenshot> <screeninfo>&kapp; Settings Dialog - The Settings page, File Transfers tab</screeninfo> <mediaobject> <imageobject><imagedata fileref="settings-kmess-settings-filetransfers.png" format="PNG"/></imageobject> <textobject><phrase>&kapp; Settings Dialog - The Settings page, File Transfers tab</phrase></textobject> </mediaobject> </screenshot> <para> Here on the File Transfers tab, you can set a couple of important options. </para> <para> When a contact sends you a file, you may want to always save it in a certain directory on your computer. Select the checkbox next to <guilabel>Save all received files in one directory:</guilabel> and specify the path to the directory you want all files to be saved in, by clicking the <guibutton>...</guibutton>. </para> <para> You can also specify the ports you want to use for file transfers. Make sure these ports are also forwarded correctly by your router, if you have one. Check the settings of your router for this. </para> </sect3> </sect2> </sect1> </chapter> <chapter id="faq"> <title>Questions and Answers</title> <!-- (OPTIONAL but recommended) This chapter should include all of the silly (and not-so-silly) newbie questions that fill up your mailbox. This chapter should be reserved for BRIEF questions and answers! If one question uses more than a page or so then it should probably be part of the "Using this Application" chapter instead. You should use links to cross-reference questions to the parts of your documentation that answer them. This is also a great place to provide pointers to other FAQ's if your users must do some complicated configuration on other programs in order for your application work. --> &reporting.bugs; <!-- &updating.documentation; --> <qandaset id="faqlist"> <qandaentry> <question><para>Do I need a hotmail account to chat with &kapp;?</para></question> <answer> <para> No, you can register any email address at <ulink url="http://register.passport.com/">the Passport site</ulink>. </para> </answer> </qandaentry> <qandaentry> <question><para>Can you add voice chat and webcam support to &kapp;?</para></question> <answer> <para> Sure! We will add it for the next major release: version 2.1. </para> </answer> </qandaentry> <qandaentry id="playing-winks"> <question><para>Why can't I play winks in &kapp;?</para></question> <answer> <para> To play winks, you need to have a Flash-player and <ulink url="http://www.cabextract.org.uk/">cabextract</ulink> installed. These packages can be installed after &kapp; is installed. </para> <para> Also verify whether you can play flash files in &konqueror;. If flash can be played in &konqueror;, it will work in &kapp;. Use the &konqueror; plugin settings to detect new plugins. </para> <para> Finally, verify if they are enabled in your Account Settings. See <xref linkend="settings-account-chat-style"/>. </para> </answer> </qandaentry> <qandaentry> <question><para> Why do the emoticons just show up as white squares? <emphasis>or</emphasis> Why does &kapp; not have any images? </para></question> <answer> <para> You installed &kapp; to the wrong directory. Basically, it should be configured to install to your &kde; 4 directory. This directory should be auto-detected, but you can also tell the configure script where to find it. For example: <command>./configure --prefix=/opt/kde4</command> To find out where KDE 4 is installed, you can run <command>kde4-config --prefix</command>. </para> </answer> </qandaentry> <qandaentry> <question><para> What ports do I have to open in my firewall to get the file transfer working? </para></question> <answer> <para> The default interval of ports is 6891-6900 TCP. You can specify which ports you want to use in the &kapp; Settings. See <xref linkend="settings-kmess-settings-filetransfers"/>. </para> </answer> </qandaentry> <qandaentry> <question><para>Why the contacts cannot see the size of my chat font?</para></question> <answer> <para> Because neither the official client nor other clients support them. The font size information is not exchanged between clients, just the name and the formatting options. </para> </answer> </qandaentry> <qandaentry> <question><para> Can I send you a theme I made, that uses &Microsoft;'s MSN emoticons, to be added to &kapp;? </para></question> <answer> <para> We are sorry, but we cannot accept it. Despite the fact that other Live Messenger clients for &Linux; use them, we will not use them as well, because there are some copyright issues in doing so. This means that the MSN emoticons are protected from unauthorized usage, which includes us using them in &kapp;. That is one of the reasons we have our own complete emoticon theme, released under the open source GPL license, for use by other Live Messenger clients for &Linux; clients if they should start feeling the same way we do. </para> <para> However, nothing stops you from distributing it yourself: for example, via the <ulink url="http://www.kde-look.org/index.php?xcontentmode=23">www.kde-look.org</ulink> site! </para> </answer> </qandaentry> <qandaentry> <question><para>How do I use &kapp; from SVN?</para></question> <answer> <para> Please take a look at the <ulink url="http://www.kmess.org/svn/">Accessing SVN</ulink> page of our project's web site. </para> </answer> </qandaentry> <qandaentry> <question><para>How do I build RPM/DEB packages?</para></question> <answer> <para> Please see <xref linkend="appendix-installation"/>. </para> </answer> </qandaentry> <qandaentry> <question><para>Have you considered joining forces with &kopete;?</para></question> <answer> <para> It has been considered and rejected. The two programs may have similar functionality in the MSN department, but they are built with radically different goals in mind. We have always felt that those multiple-protocol supporting IM programs suffer from the <quote>least-common-denominator</quote> problem. For example, if 4 protocols don't support different fonts and one does, then none will probably get font support; though they are getting better, lately. We however, focus on the MSN-specific features and the Messenger experience, making it very easy for people apt to Messenger to feel <quote>at home</quote> with &kapp;. </para> </answer> </qandaentry> <qandaentry> <question><para>Why should I use &kapp; instead of Pidgin/&kopete;/aMSN?</para></question> <answer> <para> Short answer: if you have a &kde; desktop and use only the &Windows; Live Messenger Service, &kapp; is made for you. </para> <para> Some clients are written to support multiple protocols. &kopete; for example supports many. &kapp; on the other hand, tries to support only one and its developers are working at their best to support the MSN native features and optimizing the user interface for one protocol. &kapp; also stays true to &kde; standards for look and feel. There is a choice for everyone, you are free to use what you like! </para> </answer> </qandaentry> <qandaentry> <question><para>What is the story behind the name of &kapp;?</para></question> <answer> <para> There was already a KMsn, though that was later changed to KMerlin. <quote>Mess</quote> is a short form for <quote>Messenger</quote> and also to be a self-deprecating joke. </para> <para> <quote> When I named it that, I didn't think anyone would actually end up using it. ;-) </quote> <emphasis>-- Mike K. Bennett</emphasis> </para> </answer> </qandaentry> <qandaentry> <question><para>How do I change the size of the display pictures in the contact list?</para></question> <answer> <para> From the contact list window, go to <menuchoice><guimenu>View</guimenu> <guimenuitem>Display Pictures Size</guimenuitem></menuchoice> and choose the size you would like. </para> </answer> </qandaentry> <qandaentry> <question><para>How do I show my own display picture in the chat window?</para></question> <answer> <para> You can set this by going to <menuchoice><guimenu>Account Settings</guimenu><guimenuitem>Chatting</guimenuitem> <guimenuitem>Behaviour</guimenuitem> <guimenuitem>Display your own picture in the chat window</guimenuitem></menuchoice>. </para> </answer> </qandaentry> </qandaset> </chapter> <chapter id="credits"> <title>Credits and License</title> <!-- Include credits for the programmers, documentation writers, and contributors here. The license for your software should then be included below the credits with a reference to the appropriate license file included in the KDE distribution. --> <para> <emphasis>&kapp;</emphasis> </para> <para> Copyrights: </para> <simplelist> <member>© 2002-2009 Mike K. Bennett <email>mkb137b@hotmail.com</email></member> <member>© 2005-2009 Diederik van der Boor <email>vdboor@codingdomain.com</email></member> <member>© 2007-2009 Valerio Pilo <email>amroth@coldshock.net</email></member> </simplelist> <para> The program's developers are: </para> <simplelist> <member>Mike K. Bennett <email>mkb137b@hotmail.com</email></member> <member>Michael Curtis <email>mdcurtis@users.sourceforge.net</email></member> <member>Diederik van der Boor <email>vdboor@codingdomain.com</email></member> <member>Valerio Pilo <email>amroth@coldshock.net</email></member> <member>Antonio Nastasi <email>sifcenter@gmail.com</email></member> <member>Ruben Vandamme <email>vandammeru@gmail.com</email></member> <member>Sjors Gielen <email>sjors@kmess.com</email></member> <member>Adam Goossens <email>fontknocker@gmail.com</email></member> </simplelist> <para> For a more detailed analysis of the commits to the source code, consider visiting our <ulink url="http://trac.kmess.org/timeline">&kapp; trac timeline</ulink>, and the list of <ulink url="http://www.ohloh.net/p/kmess/contributors">&kapp; contributors at ohloh.net</ulink> </para> <para> Code was taken from: </para> <para> <itemizedlist> <listitem><para> KMerlin, which provided the original inspiration for this program. </para></listitem> <listitem><para> &kopete;, from which the old popup balloons and initial MSNP2P designs were taken; those were both ultimately replaced. The MSN Challenge handler from &kopete; is still used.</para></listitem> <listitem><para>KScreensaver, from which idle detection code was taken.</para></listitem> <listitem><para> BasKet, which has a nice close-to-tray icon screenshot feature and LikeBack to let users contact the developers easily.</para></listitem> <listitem><para> Amarok, which provided the inspiration for the custom crash handler implementation.</para></listitem> </itemizedlist> </para> <para> Special thanks to: </para> <simplelist> <member>Dane Harnett (Web design) <email>dynamitedane@hotmail.com</email></member> <member>David Vignoni (The main and yellow/blue/violet emoticon sets) <email>dvgn@libero.it</email></member> <member>Julien Joubin (Cartoon emoticons) <email>jujubinche@netscape.net</email></member> <member>Christian Müller (Default sound theme) <email>cmue81@gmx.de</email></member> <member>Michael Anderton (&kapp; icon in Oxygen style) <email>mike.s.anderton@gmail.com</email></member> </simplelist> <para> Translators: </para> <simplelist> <member>Panagiotis Papadopoulos (Translations Maintainer) <email>pano_90@gmx.net</email></member> <member>Mohamed Aser (Arabic) <email>mohasr@link.net</email></member> <member>Youssef Chahibi (More Arabic) <email>chahibi@gmail.com</email></member> <member>Ma'moun Diraneyya (More Arabic) <email>mamoun.diraneyya@gmail.com</email></member> <member>Mauricio Rother (Brazilian Portuguese) <email>mauricio@digicomm.com.br</email></member> <member>Leonel Freire (More Brazilian Portuguese) <email>leonelfreire@gmail.com</email></member> <member>Sergio Rafael Lemke (More Brazilian Portuguese) <email>bedi.com@gmail.com</email></member> <member>Maurício Arozi Moraes (More Brazilian Portuguese) </member> <member>Jaume Cornadó (Catalan) <email>jaumec@lleida.net</email></member> <member>Adrià Arrufat (More Catalan) <email>swiftscythe@gmail.com</email></member> <member>Lin Haoxiang (Simplified Chinese) <email>linhaoxiang@hotmail.com</email></member> <member>Liu Sizhuang (More Simplified Chinese) <email>chinatslsz@hotmail.com</email></member> <member>Cheng Yang (More Simplified Chinese) <email>yangzju@gmail.com</email></member> <member>Yen-chou Chen (Traditional Chinese) <email>yenchou.mse90@nctu.edu.tw</email></member> <member>Tryneeds-Chinese Translation Platform (More Traditional Chinese) <email>tryneeds@gmail.com</email></member> <member>Lars Sommer (Danish) <email>admin@lasg.dk</email></member> <member>Pascal d'Hermilly (More Danish) <email>pascal@tipisoft.dk</email></member> <member>Arend van Beelen Jr. (Dutch) <email>arend@auton.nl</email></member> <member>Diederik van der Boor (More Dutch) <email>vdboor@codingdomain.com</email></member> <member>Jaap Woldringh (More Dutch) <email>jjh.woldringh@planet.nl</email></member> <member>Elve (More Dutch) <email>elve@savage-elve.net</email></member> <member>Sander Pientka (More Dutch) <email>cumulus0007@gmail.com</email></member> <member>Heimen Stoffels (More Dutch) <email>djmusic121@gmail.com</email></member> <member>Jyri Toomessoo (Estonian) <email>nuubik@hotmail.com</email></member> <member>Markus Vuori (Finnish) <email>markus@vuoret.net</email></member> <member>Joonas Niilola (More Finnish) <email>juippis@roskakori.org</email></member> <member>Jussi Timperi (More Finnish) <email>jussi.timperi@gmail.com</email></member> <member>Antony Hussi (More Finnish) <email>antony.hussi@tranciend.com</email></member> <member>Choplair (French) <email>pachilor@yahoo.co.jp</email></member> <member>Vincent Fretin (More French) <email>fretinvincent@hotmail.com</email></member> <member>Andrea Blankenstijn (More French) <email>darkan9el@gmail.com</email></member> <member>Barthe Guillaume (More French) <email>gu_barthe@yahoo.fr</email></member> <member>Scias (More French) <email>shining.scias@gmail.com</email></member> <member>Jan Tönjes (German) <email>jan.toenjes@web.de</email></member> <member>Panagiotis Papadopoulos (More German, Greek) <email>pano_90@gmx.net</email></member> <member>Dimitrios Glentadakis (More Greek) <email>dglent@gmail.com</email></member> <member>Páder Rezsõ (Hungarian) <email>rezso@rezso.net</email></member> <member>Pauli Henrik (More Hungarian) <email>henrik.pauli@drangolin.net</email></member> <member>David Vignoni (Italian) <email>dvgn@libero.it</email></member> <member>Valerio Pilo (More Italian) <email>amroth@coldshock.net</email></member> <member>Vincenzo Reale (More Italian) <email>smart2128@baslug.org</email></member> <member>Andrea Decorte (More Italian) <email>adecorte@gmail.com</email></member> <member>Daniel E. Moctezuma (Japanese) <email>shinsen27@gmail.com</email></member> <member>Park Dong Cheon (Korean) <email>pdc@kaist.ac.kr</email></member> <member>Øyvind Sæther (Norsk Bokmål) <email>oyvind@sather.tk</email></member> <member>Zoran Milovanović (Serbian) <email>provalisam@gmail.com</email></member> <member>Rastislav Krupanský (Slovak) <email>ra100@atlas.sk</email></member> <member>Matjaž Kaše (Slovenian) <email>matjaz.kase@g-kabel.si</email></member> <member>Johanna Gersch (Spanish) </member> <member>J.C.A. Javi (More Spanish) <email>yovoya30ks@hotmail.com</email></member> <member>Alejandro Araiza Alvarado (More Spanish) <email>mebrelith@gmail.com</email></member> <member>Jaume Corbí (More Spanish) <email>jaume4@gmail.com</email></member> <member>Christian Kaiser (More Spanish) <email>k39@users.sourceforge.net</email></member> <member>Juan Pablo González Tognarelli (More Spanish) <email>jotapesan@gmail.com</email></member> <member>Alexis Daniel Medina Medina (More Spanish) <email>alexismedina@gmail.com</email></member> <member>Manuel Ramírez (More Spanish) <email>elpreto@kde.org.ar</email></member> <member>Mauricio Muñoz Lucero (More Spanish) <email>real.mml@gmail.com</email></member> <member>Christian Lundgren (Swedish) <email>zeflunk@gmail.com</email></member> <member>Mattias Newzella (More Swedish) <email>newzella@gmail.com</email></member> <member>Rachan Hongpairote (Thai) <email>rachanh@yahoo.com</email></member> <member>Gorkem Cetin (Turkish) <email>gorkem@gelecek.com.tr</email></member> <member>Barbaros Ulutas (More Turkish) <email>tebarul@yahoo.com</email></member> <member>Uğur Çetin (More Turkish) <email>ugur.jnmbk@gmail.com</email></member> </simplelist> <para> Note that some translators also made other contributions. </para> <para> Contributors - which without them &kapp; wouldn't be where it is: </para> <simplelist> <member>Richard Conway (MSNP12 support, various patches) <email>richardconway@users.sourceforgenet</email></member> <member>Guido Solinas (Pictures in contact list code, contact client info, chat font zoom) <email>whereismwhite@gmail.com</email></member> <member>Pedro Ferreira (File transfer thumbnails) <email>pedro.ferreira@fe.up.pt</email></member> <member>Liu Sizhuang (P4-Context field support) <email>chinatslsz@hotmail.com</email></member> <member>Scott Morgan (Xinerama fixes) <email>blumf@blumf.freeserve.co.uk</email></member> <member>Laurence Anderson (Original file receive patch) <email>l.d.anderson@warwick.ac.uk</email></member> <member>Lin Haoxiang (file send bug fix, proxy connect code) <email>linhaoxiang@hotmail.com</email></member> <member>Mohamed Aser (internationalization of file saving fix) <email>mohasr@link.net</email></member> <member>Alexandre Peixoto Ferreira (Various internationalization fixes) <email>alexandref@o2.net.br</email></member> <member>Choe Hwanjin (Some internationalization fixes) <email>hjchoe@hancom.com</email></member> <member>Vincent Fretin (MSN6 emoticon definitions) <email>fretinvincent@hotmail.com</email></member> <member>Damien Sandras (GnomeMeeting developer) <email>dsandras@seconix.com</email></member> <member>Tobias Tönjes (Guy with a bag over his head)</member> <member>Heimen Stoffels (updated the User Manual for version 2.0) <email>cooleboy121HS@hotmail.com</email></member> <member>Andrea Decorte (Group selection in 'contact added user' dialog) <email>adecorte@gmail.com</email></member> </simplelist> <para> Documentation copyrights: </para> <simplelist> <member>© 2002 Mike K. Bennett <email>mkb137b@hotmail.com</email></member> <member>© 2007 Diederik van der Boor <email>vdboor@codingdomain.com</email></member> <member>© 2007-2009 Valerio Pilo <email>amroth@coldshock.net</email></member> </simplelist> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> <!-- FDL: do not remove. Commercial development should replace this with their copyright and either remove it or re-set this. NOTE: All documentation are licensed under the FDL, regardless of what license the application uses --> &underFDL; &underGPL; </chapter> <appendix id="appendix"> <title>Installation</title> <sect1 id="appendix-obtaining"> <title>Obtaining &kapp;</title> <para> &kapp; is not a part of the official &kde; project. </para> <para> It can be downloaded instead from <ulink url="http://www.kmess.org/">http://www.kmess.org/</ulink>. The download page also provides links to distributions which include &kapp; in their package repositories. You can usually install &kapp; directly with your package manager, without having to download it from the &kapp; website. </para> <para> However, some distributions may not supply the latest version yet. In that case it is recommended to use the &kapp; Installer, found on top of the <ulink url="http://www.kmess.org/download/">&kapp; download page</ulink>. </para> </sect1> <sect1 id="appendix-requirements"> <title>Requirements</title> <para> In order to successfully use &kapp;, you need kdelibs-4 and qt-4 installed. At &ubuntu; and Debian, kdelibs-4 is named kdelibs-5. &kapp; should be able to run on any system where kdelibs can be installed. This includes &GNU;/&Linux;, &UNIX; variants, but also &Microsoft; &Windows; and &MacOS; X. </para> <para> To play winks, you need to have the Adobe™ Flash Player and <ulink url="http://www.kyz.uklinux.net/cabextract.php">CabExtract</ulink> installed. See <xref linkend="playing-winks"/>. </para> <!-- List any special requirements for your application here. This should include: o Libraries or other software that is not included in kdesupport, kdelibs, or kdebase. o Hardware requirements like amount of RAM, disk space, graphics card capabilities, screen resolution, special expansion cards, etc. o Operating systems the app will run on. If your app is designed only for a specific OS, (you wrote a graphical LILO configurator for example) put this information here. --> <!-- For a list of updates, you may refer to the application web site or the ChangeLog file, or ... --> <para> To see a list of changes in newer versions, see: </para> <simplelist> <member>The &kapp; homepage: <ulink url="http://www.kmess.org/">http://www.kmess.org/</ulink></member> <member>The changelog online: <ulink url="http://www.kmess.org/changes/">http://www.kmess.org/changes/</ulink></member> <member>The developer weblogs: <ulink url="http://www.kmess.org/blogs/">http://www.kmess.org/blogs/</ulink></member> </simplelist> <para> The ChangeLog and NEWS file of the release should also be installed in <filename class="directory">/usr/share/doc/packages</filename> somewhere. </para> </sect1> <sect1 id="appendix-installation"> <title>Installation</title> <para> &kapp; can be installed through several channels: </para> <para> <itemizedlist> <listitem><para>The &kapp; Installer package</para></listitem> <listitem><para>Official packages supplied by your own distribution/vendor</para></listitem> <listitem><para>Compiled from source code</para></listitem> </itemizedlist> </para> <para> Each method has its own advantages. We recommend to use the <quote>&kapp; Installer</quote> package from our download page, as it always contains the most recent version of &kapp;. </para> <para> To download the &kapp; Installer package or corresponding source code package, visit: <ulink url="http://www.kmess.org/download/">http://www.kmess.org/download/</ulink> </para> <sect2 id="appendix-installation-autopackage"> <title>Using the &kapp; Installer</title> <para> The &kapp; Installer package works on every x86 &Linux; system. It needs a &kde; version of 4.1 or higher. Please follow the <ulink url="http://www.autopackage.org/docs/howto-install/">instructions to install</ulink> the package. It is worth mentioning the installer has a <ulink url="http://www.autopackage.org/gallery.html">user-friendly look</ulink>. </para> </sect2> <sect2 id="appendix-installation-sourcecode"> <title>Installing from Source Code</title> <para> Installation from source code is more difficult, as it may require some troubleshooting during the installation process. This is only needed when a binary package is not available, or doesn't support the system you use. All binary packages at the download page are also created from the source package. </para> <sect3 id="appendix-installation-sourcecode-prepare"> <title>System Preparation</title> <para> Before a &Linux; system is able to install from source, a few additional packages need to be installed: </para> <para> <itemizedlist> <listitem><para> make </para></listitem> <listitem><para> gcc-c++ </para></listitem> <listitem><para> autoconf </para></listitem> <listitem><para> automake </para></listitem> <listitem><para> build-essential </para></listitem> <listitem><para> gettext </para></listitem> </itemizedlist> </para> <para> In many &Linux; distributions, many packages have a separate <quote>dev</quote> or <quote>devel</quote> package too. Use your package-manager to find the following packages, and install them: </para> <para> <itemizedlist> <listitem><para>qt-devel (can also be called qt4-devel)</para></listitem> <listitem><para> kdelibs-devel (can also be called kdelibs4-devel, kdelibs5-devel on Debian/&ubuntu;) </para></listitem> <listitem><para>x-devel (can also be called xfree-devel/xorg-x11-devel/xorg-devel)</para></listitem> <listitem><para>libstdc++-devel</para></listitem> </itemizedlist> </para> <para> You might need some creativity here, the package names differ slightly between &Linux; distributions. </para> <para> It is very likely that you will be prompted to install the dependencies of these packages. If this doesn't happen, make sure you have the following packages installed as well: </para> <itemizedlist> <listitem><para>fontconfig-devel</para></listitem> <listitem><para>freetype2-devel</para></listitem> <!-- <listitem><para>libfam-devel (or fam-devel) </para></listitem> --> <listitem><para>libjpeg-devel</para></listitem> <listitem><para>libpng-devel</para></listitem> <listitem><para>zlib-devel</para></listitem> </itemizedlist> </sect3> <sect3 id="appendix-installation-sourcecode-extract"> <title>Extract the Source package</title> <para> After you downloaded the source package, extract it with: </para> <screen width="40"><prompt>$</prompt> <userinput>tar zxvf kmess-&tarversion;.tar.gz</userinput></screen> <para> Then navigate to the newly created directory: </para> <screen width="40"><prompt>$</prompt> <userinput>cd kmess-&tarversion;/</userinput></screen> </sect3> <sect3 id="appendix-installation-sourcecode-compilation"> <title>Starting the Compilation</title> <para> This step translates the &kapp; source code to an executable program. Run the following commands to compile &kapp;: </para> <screen width="40"><prompt>$</prompt> <userinput>./configure</userinput> <prompt>$</prompt> <userinput>make</userinput></screen> <para> The first command verifies your system. It stops if a required package cannot be found. This often happens when you forgot to install some of the accompanied <quote>devel</quote> packages. </para> <para> The second command builds the application. This step can take from 2 up to 5 or even 10 minutes, depending on your system. When this command completes you will have a runnable program at: </para> <screen width="40"><prompt>$</prompt> <userinput>./kmess/kmess</userinput></screen> </sect3> <sect3 id="appendix-installation-sourcecode-installing"> <title>Installing</title> <para> It is finally possible to install! Run the following command. It will ask for your root password first. </para> <screen width="40"><prompt>$</prompt> <userinput>su -c 'make install'</userinput></screen> <para> On Debian and Debian based systems like &ubuntu; (and all of its derivates, like &kubuntu;) use the following command: </para> <screen width="40"><prompt>$</prompt> <userinput>sudo make install</userinput></screen> <para> Alternatively, you can use <ulink url="http://asic-linux.com.mx/~izto/checkinstall/"> Checkinstall</ulink> to install the application instead. This makes it easier to uninstall &kapp; later. Using checkinstall, the installation becomes: </para> <screen width="40"><prompt>$</prompt> <userinput>su -c 'checkinstall'</userinput></screen> <para> Or on Debian based systems: </para> <screen width="40"><prompt>$</prompt> <userinput>sudo checkinstall</userinput></screen> </sect3> </sect2> <sect2 id="appendix-installation-buildpackage"> <title>Building a &kapp; Package</title> <para> The rpmbuild command is suitable for distibutions using the RPM package format. This includes distributions like SuSE, Mandriva, Redhat and Fedora. A &kapp; RPM package can be created with the command: </para> <screen width="40"><prompt>$</prompt> <command>rpmbuild -tb kmess-&tarversion;.tar.gz</command></screen> <para> The rpmbuild command runs a full source-based installation, but builds a package instead of installing &kapp;. The final package can be found in a subdirectory of <filename class="directory">/usr/src/packages</filename> or <filename class="directory">/usr/src/rpm</filename>. You can use that package to install &kapp;. </para> <para> If you have a clean, newly-installed system, without any &kde; upgrades, you can share the package with others. Make sure users can always download the source package too, as required by the GPL license. However, we recommend to use our &kapp; Installer whenever possible. </para> <para> Tip: when you install the <ulink url="http://www.autopackage.org/download-tools.html"> autopackage-devel</ulink> tools before building the RPM package, the rpm spec script uses <ulink url="http://www.autopackage.org/aptools.html">apbuild </ulink> to create a cleaner binary. </para> </sect2> </sect1> </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: -->