The KMess Handbook

# The KMess Handbook

Mike K. Bennett `<mkb137b@hotmail.com>`

Diederik van der Boor `<vdboor@codingdomain.com>`

Valerio Pilo `<valerio@kmess.org>`

Heimen Stoffels `<cooleboy121HS@hotmail.com>`

Panagiotis Papadopoulos `<pano_90@gmx.net>`

Revision 2.0 (2009-03-27)

Copyright © 2002 Mike K. Bennett

Copyright © 2007 Diederik van der Boor

Copyright © 2009 Valerio Pilo

Legal Notice

KMess 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 Mac® OS. The strength of KMess 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.

Chapter 1. Introduction
Introduction

## Chapter 1. Introduction

KMess is an alternative Instant Messaging client for Linux®.

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 “letter” format. In contrast to email, the parties always know whether their peer is available to start an interactive chat conversation.

KMess 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 Mac® OS X. MSN Messenger has been renamed to Windows® Live Messenger in February 2006. Its name is still commonly known and often shortened to “MSN”, or nowadays “WLM”, by its users.

The strengths of KMess 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, KMess is free software. The licensing terms are the GNU General Public License.

Some feature highlights:

- Communicate with contacts who use other Windows® Live Messenger client software.

- Rich, colorful chat styles.

- Multiple accounts are supported.

- Chat log browser to show old discussions.

- Chat logs styled as the original conversation.

- Fast file transfers including thumbnail previews for any file type.

- Automatic reconnection in case of connection failure.

- Chat windows can be used again after reconnecting.

- Non invasive and customizable notifications and warning messages.

- Notifications can be blocked when the status is set to Busy.

- Nudges can be blocked, winks can be hidden.

- Annoying custom emoticons can be blacklisted.

- Many options to customize the chats and the contacts list.

At the moment, KMess supports these WLM-specific features:

- Display pictures exchange.

- Fast file transfers.

- Chatting with offline and invisible contacts.

- Nudges.

- Custom emoticons.

- Winks.

- Ink (hand-written) messages.

- Exchange of “Now Playing...” information.

- Email notifications for Hotmail/Live Mail accounts.

- “Messenger Plus!” features: text formatting, tabbed chat windows.

Chapter 2. Using KMess
Using KMess

## Chapter 2. Using KMess

## Logging in

Because KMess 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 - e.g. you have used Windows® Live Messenger before - you can use this account for KMess too. Otherwise, you can create an account at the Microsoft® Passport web site. After you created the account, you can log in to use KMess.

### Creating an Account

To create a new account, you can either create a new free Windows® Live Hotmail address, or register your own email address at register.passport.com . A link to this site is also found at the login screen of KMess After you have completed the registration process, you can use your email address to login.

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 “Request verification email” link in the account settings page of KMess.

You can manage the accounts saved within KMess from the KMess settings dialog. To learn more about it, see the section called “Accounts Page”.

### Logging in

Enter the email address and the password of your account to connect. It is recommended to enable the Remember account option, as it saves your account preferences before you quit KMess. If you want KMess to store your password, you can also enable the Remember password checkbox. Use Connect to continue.

To ease the login process by only using the keyboard, you can press Tab 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 KMess just choose it from the drop-down list. The display picture will reflect the last known picture for that account or the KMess logo if none was found. Clicking on the display picture will open the settings of the selected account, using the mouse wheel will switch between the saved accounts.

You should not enable the Remember account 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 KMess. Also any changes made to the settings of a guest account will be lost.

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 KMess passwords. However, if the KDE Wallet is not available, KMess will store the unencrypted account passwords in the file `~/.kde4/share/config/kmessrc` (`~` 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 Remember password checkbox provided in KMess's startup screen.

After logging in, your contact list appears. This is described in the next section.

Using the Contact List
Using the Contact List

## Using the Contact List

The contact list gives you an organized overview of the buddies (the “contacts”) 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:

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 right mouse button on the contact. This will pop up the following context menu:

Hovering with the mouse over the name of a contact, brings up a tooltip with information about that contact.

### Setting your Appearance

#### Changing your Status

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 KMess window. The second way is to change the status with Connect → My Status from the main KMess window. The third is to click with the right mouse button on the KMess tray icon, then click My Status. You can select from the following different states:

- Online

- Away

- Away with Auto-Reply

- Idle

- Be Right Back

- Busy

- Out to Lunch

- On the Phone

- Invisible

The last item of the menu allows you to disconnect from the Live service.

KMess differentiates between two “Away” states:

- The standard “Away” status which is the one you may be familiar with from other Instant Messenging clients.

- When you set your status to “Away with Auto-Reply”, 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.

By default, KMess switches your status to “Idle” after 5 minutes of inactivity. This setting can be changed or disabled in the Account → Status Options section of the Account Settings.

### Starting Chat Conversations

#### Starting a Chat with a Contact

Click with the left mouse button on an available contact in the contact list, or choose Chat from its context menu, accessible by clicking with the right mouse button on the contact. The chat window will open and you can start chatting with the contact.

#### Starting a Chat with Multiple Participants

Open a chat with a contact as described in the section called “Starting a Chat with a Contact”. In the opened chat window, go to Chat → Invite.... 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 right arrow icon button. 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 left arrow icon button. 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 add button.

### Managing Contacts

#### Adding a Contact

Use the menu Actions → New Contact.... 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 OK, the contact will be added to your contact list.

#### Removing a Contact

On the contact list, click with the right mouse button on the contact you would like to remove. Choose Delete Contact from the context menu. A dialog will open, where you can select to either:

- Remove the contact but still allow him or her to see your status.

- Remove and block the contact, to disallow him or her from either talking to you, or even seeing your online status.

After clicking on OK, either option will cause the contact to disappear from your contact list.

#### Blocking a Contact

On the contact list, click with the right mouse button on the contact you would like to block. Choose Block Contact 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.

#### Unblocking a Contact

On the contact list, click with the right mouse button on the contact you would like to unblock. Choose Unblock Contact from the context menu. The contact will be unblocked.

#### Copying a Contact to Another Group

On the contact list, click with the right mouse button on the contact you would like to copy to another group. Choose Copy to Group 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.

#### Moving a Contact to Another Group

On the contact list, click with the right mouse button on the contact you would like to move to another group. Choose Move to Group 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.

#### Renaming Contacts

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 the section called “The Contact properties Dialog”.

#### Removing a Contact from a Group

On the contact list, click with the right mouse button on the contact you would like to remove from a group. Choose Remove From Group. The contact is then removed from the group.

If the contact is not present in any of your groups, KMess will automatically place him or her in a special group called “Individuals”.

### Managing Groups

#### Adding a Group

Use the menu Actions → New Group.... A window appears, where you can enter a name for the new group. Confirm your choice by clicking OK. The new group will be added to your contact list.

#### Rename a Group

On the contact list, click with the right mouse button on the name of the group you would like to rename. Choose Rename Group from the context menu. You will now be asked for a new name for the group. After confirming the action by clicking OK, the group will be renamed.

#### Removing a Group

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 right mouse button on the name of the group you would like to remove. Choose Remove Group from the context menu. You will need to confirm the action, by clicking on Remove.

### Changing the Contact List Appearance

#### Sorting Contacts

Use the menu View → Sort Contacts by. There are three different sorting modes available:

Group

  Your contacts will be each placed in the groups they belong to.

Online/Offline

  The contact list will only show the “Online” and the “Offline” groups, and your contacts will be shown in one or the other, depending if they are online or not.

Mixed

  This will make the contact list to display all available contacts in their respective groups, like with the “Group”. Unlike it however, all contacts who are currently offline will only appear in the Offline group.

#### Show Allowed Contacts

This option is available by using the menu option: View → Show Allowed Contacts. When enabled, it adds an additional group to your contact list, named “Allowed”. 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 “Allowed” group if they no longer have you listed in their contact list.

#### Show Removed Contacts

This option is available by using the menu option: View → Show Removed Contacts. When enabled, it adds an additional group to your contact list, named “Removed”. It contains all the known removed contacts, who are contacts that you removed from your contact list.

### Other Actions in the Contact List Window

#### Changing your own Personal Message

KMess supports Windows® Live Messengers Personal Message feature: under the displayed friendly name in the contact list window, you will see the text: “<Enter your personal message here>”. 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.

#### Send an Email to a Contact Using your Live Mail Account

On the contact list, click with the right mouse button on the name of the contact you would like to send a mail to. Choose Send Email from the context menu. KMess will open your Live Mail Account in your favorite web browser, direct at the “Compose” page.

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 Send Email from the context menu. To read more about the Contacts Panel, see the section called “Panels”.

#### See the Live Profile of a Contact

On the contact list, click with the right mouse button on the name of the contact you would like to see the profile of. Choose View Profile from the context menu. KMess 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 View Profile from the context menu. To read more about the Contacts Panel and how to open it, see the section called “Panels”.

#### Viewing your Personal Live Profile

Go to Connect → Show My Profile. KMess will then open your personal Live Profile in your favorite web browser.

#### Open your Live Mail Inbox Using KMess

This option is only available if your email address has been created with Hotmail or Windows® Live.

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.

To enable or disable this option, see the section called “Contact List Page”.

Using the Chat Windows
Using the Chat Windows

## Using the Chat Windows

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 the section called “Starting a Chat with a Contact” and the section called “Starting a Chat with Multiple Participants”.

By default, KMess will display all your chats within a single window, each one within a tab: you can learn more about this behavior in the section called “Tabbed Chats”.

### Chatting

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.

When you are done writing a message, you can press Enter to instantly send it, or click the Send button at the bottom right of the message editing area.

To insert a new line in your message, press Shift+Enter or click the New line button at the bottom right of the message editing area.

On the right side of the window, you will see the Contacts Panel, present by default. To learn more about the panels, see the section called “Panels”.

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 the section called “Tabbed Chats”.

You can define shortcuts for all the actions you can perform in chat. You can go to Settings Configure Shortcuts... 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; Alt+Z, to send a nudge, and Ctrl+Up and its counterpart Ctrl+Down, which allow you to easily scroll through the past chat messages and read what has been written previously.

### Emoticons

KMess comes with the default emoticons theme made by David Vignoni.

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.

You can also enable a separate Panel to always keep your emoticons at hand. To learn more about the panels, see the section called “Panels”.

### Custom Emoticons

KMess can send your own created emoticons to your friends, and receive theirs.

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.

You can also enable a separate Panel to always keep your custom emoticons at hand. To learn more about the panels, see the section called “Panels”.

When you use KMess 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:

- Save the emoticons you received from contacts

- Add emoticons by choosing images from your computer

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:

You may also use this dialog to can change the text shortcut associated with the new emoticon. By clicking the Ok button, the new emoticon will instantly be available.

Alternatively, you can manage your emoticons from the Account Settings dialog. To learn more about the Account Settings, see the section called “Emoticons Page”.

### File Transfers

KMess supports transferring files through MSN. To send a file to a contact, you first have to open a chat with him or her.

Then you can send a file by choosing from the menu Chat → Send File. Choose the file you want to send to the contact. Confirm the action by clicking OK. Otherwise, you can click on the Send a File button, located on the chat toolbar.

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.

After your contact accepts the file transfer, the KMess file Transfer Window will appear and the file transfer will start.

Please note that Live Messenger does not allow to its users to accept more than five file transfers at once for each contact.

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 the section called “Settings Page”. If you're behind a NAT router, you also need to make sure these ports are also forwarded to your local computer.

### Panels

The panels are movable and closeable areas of the chat window, where additional information and other useful things are displayed. Currently KMess provides the following panels:

- Contacts

- Emoticons

- Custom emoticons

The “Emoticons” and “Custom emoticons” panels can also be displayed as buttons below the message editing area.

The panels can be moved wherever you like: just click and hold the left mouse button 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.

If you do not like a panel, you can click on the little “X” button near the panel name, or you can do it from the menu: View → Panels then choose the panel to hide.

#### Contacts Panel

The contacts panel provides you with information and functions associated with each contact who is participating to the chat. Information includes:

- Display picture

- Email address (by clicking on the display picture)

- Contact status

- Personal message

Click with the left mouse button or right mouse button on the display picture of a contact in the contacts panel, to bring up a context menu with even more operations:

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 Display your own display picture in the chat window. Clicking your display picture there will bring up the account settings. To learn more about how to enable this option, see the section called “Chat Behavior”.

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.

#### Emoticons Panels

There are two emoticon panels: the “emoticons panel” and the “custom emoticons panel”. The only difference between them is that the first one shows the default emoticons (which are like the standard MSN emoticons but with the KMess style), and the second one shows the custom emoticons you currently have.

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.

### Nudges

KMess 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.

To send a nudge, you can either click on the Nudge toolbar icon, or select Chat → Send a Nudge!. 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.

Unlike Windows® Live Messenger, KMess 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 the section called “Chatting Page”.

### Zooming

You may find that the text in your chat window is too small or too big. Use the menu items View → Zoom In and View → Zoom Out, to increase or decrease the font size displayed in the chats.

### Save Chat Sessions

To save an active chat session to a file, you can click on Chat → Save Chat... in the chat window menu. Choose the directory where the chat should be saved and name the file. Save the chat now by clicking OK. Also see the section called “Chat Logging”.

Using Chat History
Using Chat History

## Using Chat History

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.

To access the chat history dialog you can:

- Click with the right mouse button on a contact in the contact list and choose Show Chat History..., or,

- Choose Actions → Show Chat History... from the contact list window.

Note: Chat logging is not enabled by default; see the section called “Chat Logging” for information on enabling it.

Exporting your Contact List
Exporting your Contact List

## Exporting your Contact List

Occasionally it is helpful to export your contact list. KMess supports export of your contact list into either CSV or XML format.

Choose Actions → Export Contact List... from the contact list window to open the Export dialog.

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. KMess allows to export three pieces of data: The contact handle, their friendly name, and their current personal message.

Finally, select which filetype to export to and choose Export....

Chapter 3. Configuring KMess
Configuring KMess

## Chapter 3. Configuring KMess

KMess can be customized as you wish. The settings of KMess are organized in the following groups:

- Global settings (e.g. which web browser to use).

- Personal settings for every account (e.g. your name, and picture).

- Settings for a specific contact (e.g. a setting a contact alias).

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 KMess will use, from the Configure KMess dialog.

To learn more about the account settings, see the section called “The Settings Dialog”. To learn more about the contact settings, see the section called “The Contact properties Dialog”. To learn more about the “configure KMess dialog”, see the section called “The KMess Settings Dialog”.

## The Contact properties Dialog

On the contact list, click with the right mouse button on the contact you would like to customize. Choose Properties and the contact properties dialog will appear.

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.

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 Disable notifications for this contact. KMess also allows the user to choose a particular sound to be played when the contact comes online or goes offline.

The second tab, “Display Pictures”, contains a list of all display pictures the contact has used. By clicking on Clear Cache you can delete the display pictures. You can also “steal” a display picture from the contact, using it as your own, by clicking on Use As Display Picture.

The third tab, “Notes”, 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 the section called “Contacts Panel”.

The fourth tab, “Emoticons”, allows you to restore previously hidden emoticons from that contact. Just select the entry you want to restore and click on Restore.

The Settings Dialog
The Settings Dialog

## The Settings Dialog

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.

You can open this dialog from your contact list window, via the menu: Actions → Configure Account..., or from the tray icon, clicking with the right mouse button on the KMess tray icon, then clicking Configure Account....

### Account Page

From this page you can manage the most important details of your MSN account.

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 the section called “Creating an Account” for more details). You also cannot change it unless you are currently connected with that account.

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.

The password field is usually blank. If you wish that KMess remembers your password, you can enter it here and check the checkbox next to Remember password.

Your display picture can be easily changed by clicking on the Change... button. A menu with three options will appear:

Browse...

  Use this option to select an image from your computer. The picture will be automatically scaled to the mandatory size of 96x96 pixels.

Browse and Crop Picture...

  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 OK, and KMess will resize it and set is as your display picture automatically.

Set Previous Image...

  Use this option if you want to choose a display picture you previously already had used.

Below the button, the “Do not use” checkbox allows you to not use any display picture at all.

The Log in with this account automatically checkbox, when enabled, causes KMess to automatically connect to MSN with this account every time the application is started. Choosing an MSN status from the Login as dropdown list, will make KMess set that status everytime you login to the Windows® Live Messenger service.

The second tab, Status Options, contains some status-related options. The Change status to Idle when inactive checkbox causes KMess to change your status from “Online” to “Idle” 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.

The Disable notifications when your status is set to Busy checkbox will prevent all contact status and message notifications from disturbing you if your status is set to “Busy”.

### Contact List Page

This page contains some options which affect the contact list window.

The Display a count of unread email 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.

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, KMess will discover which media player you are using and automatically show your friends the details of the tracks you are listening to. Enable the Show contacts which song I am listening to checkbox to activate this feature. When you listen to music, KMess will show the track name in the upper part of your contact list. KMess supports a wide range of media players: all players supporting the MPRIS specification are automatically supported. The following list shows some of the currently supported players:

- amaroK 1.x

- Amarok 2

- Audacious

- BMPx

- Dragon Player

- JuK

- Kaffeine

- KsCD

- Qmmp

- VLC Media Player

- XMMS2

Disabling the option Show background image removes the KMess logo, the hummingbird, from the contact list background.

The next two options affect how the friendly names of your contacts will be displayed. The Enable "Messenger Plus!" formatting 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 Show the email address of contacts instead of their friendly name does just that, if you prefer seeing the email address of your contacts instead of their friendly name, you can enable it.

### Emoticons Page

KMess 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 www.kde-look.org site.

The default KMess emoticon theme is named “KMess-New”, which contains the emoticons created by David Vignoni.

Note that not every emoticon from an emoticon theme can be used by KMess currently. Instead of replacing all your emoticons and emoticon shortcuts, KMess 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, KMess looks if the emoticon theme has a new image for the “:)” shortcut, one for the “:P” shortcut, etc..

From the left tab, Emoticon Themes, you can choose which emoticon theme KMess will use to show the default MSN emoticon shortcuts, like “:-)” and “:P”.

Besides MSN emoticon themes, KMess 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 the section called “Custom Emoticons” to learn more about their usage.

Any item you see in the list is an emoticon, with the shortcut displayed below it. Select an item and click the Remove button to delete it. Click the Rename button, or directly click on an item, to change the shortcut for the selected emoticon.

To create a new custom emoticon from an image on your computer, click on the Add New... button. A dialog window will pop up:

Click the ... 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 ... 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 OK button to instantly add it to your custom emoticons theme.

To save your changes to the theme, be sure to confirm them by clicking the OK or the Apply buttons.

### Chatting Page

This page customizes the appearance of your chat windows, and the formatting of chat messages.

#### Chat Style

The first tab of this page contains many options to customize how the chats look like. KMess allows you to choose between various styles for your chat windows. To learn more about the available chat styles, see the section called “Chat Styles”.

You can choose the chat style between the available ones using the Chat style drop-down menu. If you want to try out new things, click the Get New Styles... 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!

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 Show emoticons checkbox you can choose whether to show any emoticon in chat, or not. The Show winks checkbox allows you to hide received winks, which may be annoying.

When the Group follow-up messages from the same contact 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.

The Show timestamp 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.

##### Chat Styles

KMess allows you to choose between various styles for your chat windows. The default theme is called 'Fresh', which displays the participants' pictures:

Another style is “Classic”. This theme comes into two flavors, default and compact. The second lets KMess display the messages in a more compact fashion than the first. Take a look at the image below to see the difference:

#### Chat Text

The second tab of the settings page, Text, allows to define how the text in chats will be shown.

To change how your own chat messages are formatted, use the controls below Your message font. 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.

Sometimes your contacts use fonts or colors that you might not like or that are difficult to read: activating the Force messages from your contacts to use this font, 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.

Use font effects in messages will enable font effects as often seen in IRC clients: Words surrounded by asterisks (e.g. *bold*) will be displayed with a bold font, those surrounded by forward slashes (e.g. /italics/) will be shown italicized, and those surrounded by underscores (e.g. _underline_) will be underlined.

The last checkbox, Enable "Messenger Plus! formatting, will enable “Messenger Plus!” 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.

#### Chat Behavior

The third and last tab contains some options important to define how the chat windows will behave and will look like.

To disable the graphical effects seen when receiving and sending nudges, you can disable the Shake the chat window when a nudge is received or sent checkbox.

If Display your own display picture in the chat window 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 the section called “Contacts Panel”.

The last option of this page controls how your chats will be grouped together in windows or tabs.

##### Tabbed Chats

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, KMess comes with tabbed chats enabled by default.

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 Ctrl+W 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.

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 middle mouse button.

These are the available chat grouping options:

Always

  All your chats are grouped together in one chat window, separated by tabs.

Never

  This option will mimic the Windows® Live Messenger behavior of one window per chat. Tabs are never used.

For contacts in the same group

  If you choose this option, KMess will use tabs for contacts in the same group. For example, suppose you have the “Friends” and “Coworkers” 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.

### Chat Logging

KMess 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).

Enable the Enable chat logging checkbox to have KMess save all chats. You will be able to look them up later in the Actions menu of the contact list window, or through the right click context menu of a contact.

The chats logs are not readily available without having KMess open: if you want, you can have KMess save your chats also in a common format, to be able to access your chat logs even if KMess is not running. To do so, enable the Additionally save chats logs to file checkbox.

You can choose the format to save the additional logs in by using the File format used for saving drop-down list. Normally you want to go for the Web Pages (HTML) 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, Plain Text, the saved files will only contain basic information displayed in an IRC-like fashion.

You can also select how to separate and organize your additional chat log files: KMess 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 Year, by Year then Month, by Year, Month then Day or to Do not organize files at all.

The organizing directory will be created, accordingly to your choice, within the directory you can choose at the bottom. After applying the settings, KMess will start to automatically saving all chats.

The KMess Settings Dialog
The KMess Settings Dialog

## The KMess Settings Dialog

The KMess 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.

You can open it from your Contact List window, via the menu: Actions → Configure KMess..., or from the tray icon, clicking with the right mouse button on the KMess tray icon, then clicking Configure KMess....

### Accounts Page

This page lists all the accounts known by KMess. All changes made in this page will be applied immediately, without you having to press the OK or the Apply buttons.

By selecting an account from the list, you can choose to open the Account Settings dialog for that account with the Edit button, or remove it with the Remove button. In the latter case, you will be asked if you are sure you want to delete the account.

Click on the Add New... button to create a new account: the Account Settings page will appear, to allow you to immediately change its details.

### Notifications Page

From this page, you are able to configure how KMess notifies you about contacts who come online, new incoming messages, and also how it will show you informations and errors.

The list shows the various event types supported by KMess, 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.

The following events are available:

- A contact has started a chat with you

- A contact has gone offline

- A contact has come online

- A contact has changed its MSN status

- You have received a new email

- You received a message from a contact

- A contact requires your attention

- Information on network and application status

For each event, you can choose many actions to perform:

Play a sound

  A sound will be played: there are default sounds played for most actions, but you can change them with your favorite ones. The little Play button allows you to preview the selected sound.

Show a message in a popup

  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 KMess tray icon.

Log to a file

  The event will be noted into a file of your choice.

Mark taskbar entry

  The event will cause the corresponding window to be highlighted in your task bar.

Run command

  When the event occurs, a shell command of your choice will be executed.

### Settings Page

This page contains some generic settings of the application.

#### Web Browser

Here you can define which web browser will be invoked by KMess when you open your webmail or click on a link in chat. KMess provides the option to use a custom web browser instead of the KDE default one (which is Konqueror, usually).

To use for example Firefox instead of the KDE default browser, change the radiobutton from Use the KDE default browser to Use an installed browser: and choose the one you want to use from the drop-down list.

Additionally, KMess allows you to run your own browser, if it is not present in the aforementioned list. Select the Specify a custom command radiobutton and enter the path or the name of the browser. To specify the URL that the browser should open, add “%u” to the parameters.

#### Email Client

Here you can define which email client will be invoked by KMess 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 Use Live Mail if the account supports it checkbox.

To use Thunderbird for example instead of the KDE default email client, change the radiobutton from Use the KDE default email client to Use an installed email client: and choose the one you want to use from the drop-down list.

Additionally, KMess allows you to run your own browser, if it is not present in the aforementioned list. Select the Specify a custom command radiobutton and enter the path or the name of the browser. To specify the URL that the browser should open, add “%u” to the parameters.

#### File Transfers

Here on the File Transfers tab, you can set a couple of important options.

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 Save all received files in one directory: and specify the path to the directory you want all files to be saved in, by clicking the ....

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.

Chapter 4. Questions and Answers
Questions and Answers

## Chapter 4. Questions and Answers

4.1. Do I need a hotmail account to chat with KMess?
4.2. Can you add voice chat and webcam support to KMess?
4.3. Why can't I play winks in KMess?
4.4. Why do the emoticons just show up as white squares? or Why does KMess not have any images?
4.5. What ports do I have to open in my firewall to get the file transfer working?
4.6. Why the contacts cannot see the size of my chat font?
4.7. Can I send you a theme I made, that uses Microsoft®'s MSN emoticons, to be added to KMess?
4.8. How do I use KMess from SVN?
4.9. How do I build RPM/DEB packages?
4.10. Have you considered joining forces with Kopete?
4.11. Why should I use KMess instead of Pidgin/Kopete/aMSN?
4.12. What is the story behind the name of KMess?
4.13. How do I change the size of the display pictures in the contact list?
4.14. How do I show my own display picture in the chat window?

4.1. | Do I need a hotmail account to chat with KMess?
| No, you can register any email address at the Passport site.
4.2. | Can you add voice chat and webcam support to KMess?
| Sure! We will add it for the next major release: version 2.1.
4.3. | Why can't I play winks in KMess?

To play winks, you need to have a Flash-player and cabextract installed. These packages can be installed after KMess is installed.

Also verify whether you can play flash files in Konqueror. If flash can be played in Konqueror, it will work in KMess. Use the Konqueror plugin settings to detect new plugins.

Finally, verify if they are enabled in your Account Settings. See the section called “Chat Style”.

4.4. | Why do the emoticons just show up as white squares? or Why does KMess not have any images?
| You installed KMess 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: ./configure --prefix=/opt/kde4 To find out where KDE 4 is installed, you can run kde4-config --prefix.
4.5. | What ports do I have to open in my firewall to get the file transfer working?
| The default interval of ports is 6891-6900 TCP. You can specify which ports you want to use in the KMess Settings. See the section called “File Transfers”.
4.6. | Why the contacts cannot see the size of my chat font?
| 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.
4.7. | Can I send you a theme I made, that uses Microsoft®'s MSN emoticons, to be added to KMess?

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 KMess. 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.

However, nothing stops you from distributing it yourself: for example, via the www.kde-look.org site!

4.8. | How do I use KMess from SVN?
| Please take a look at the Accessing SVN page of our project's web site.
4.9. | How do I build RPM/DEB packages?
| Please see the section called “Installation”.
4.10. | Have you considered joining forces with Kopete?

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 “least-common-denominator” 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 “at home” with KMess.

4.11. | Why should I use KMess instead of Pidgin/Kopete/aMSN?

Short answer: if you have a KDE desktop and use only the Windows® Live Messenger Service, KMess is made for you.

Some clients are written to support multiple protocols. Kopete for example supports many. KMess 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. KMess also stays true to KDE standards for look and feel. There is a choice for everyone, you are free to use what you like!

4.12. | What is the story behind the name of KMess?
| There was already a KMsn, though that was later changed to KMerlin. “Mess” is a short form for “Messenger” and also to be a self-deprecating joke. “ When I named it that, I didn't think anyone would actually end up using it. ;-) ” -- Mike K. Bennett
4.13. | How do I change the size of the display pictures in the contact list?
| From the contact list window, go to View → Display Pictures Size and choose the size you would like.
4.14. | How do I show my own display picture in the chat window?
| You can set this by going to Account Settings → Chatting → Behaviour → Display your own picture in the chat window.

Chapter 5. Credits and License
Credits and License

## Chapter 5. Credits and License

KMess

Copyrights:

(c) 2002-2009 Mike K. Bennett `(mkb137b AT hotmail.com)`
(c) 2005-2009 Diederik van der Boor `(vdboor AT codingdomain.com)`
(c) 2007-2009 Valerio Pilo `(amroth AT coldshock.net)`

The program's developers are:

Mike K. Bennett `(mkb137b AT hotmail.com)`
Michael Curtis `(mdcurtis AT users.sourceforge.net)`
Diederik van der Boor `(vdboor AT codingdomain.com)`
Valerio Pilo `(amroth AT coldshock.net)`
Antonio Nastasi `(sifcenter AT gmail.com)`
Ruben Vandamme `(vandammeru AT gmail.com)`
Sjors Gielen `(sjors AT kmess.com)`
Adam Goossens `(fontknocker AT gmail.com)`

For a more detailed analysis of the commits to the source code, consider visiting our KMess trac timeline, and the list of KMess contributors at ohloh.net

Code was taken from:

- KMerlin, which provided the original inspiration for this program.

- 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.

- KScreensaver, from which idle detection code was taken.

- BasKet, which has a nice close-to-tray icon screenshot feature and LikeBack to let users contact the developers easily.

- Amarok, which provided the inspiration for the custom crash handler implementation.

Special thanks to:

Dane Harnett (Web design) `(dynamitedane AT hotmail.com)`
David Vignoni (The main and yellow/blue/violet emoticon sets) `(dvgn AT libero.it)`
Julien Joubin (Cartoon emoticons) `(jujubinche AT netscape.net)`
Christian Müller (Default sound theme) `(cmue81 AT gmx.de)`
Michael Anderton (KMess icon in Oxygen style) `(mike.s.anderton AT gmail.com)`

Translators:

Panagiotis Papadopoulos (Translations Maintainer) `(pano_90 AT gmx.net)`
Mohamed Aser (Arabic) `(mohasr AT link.net)`
Youssef Chahibi (More Arabic) `(chahibi AT gmail.com)`
Ma'moun Diraneyya (More Arabic) `(mamoun.diraneyya AT gmail.com)`
Mauricio Rother (Brazilian Portuguese) `(mauricio AT digicomm.com.br)`
Leonel Freire (More Brazilian Portuguese) `(leonelfreire AT gmail.com)`
Sergio Rafael Lemke (More Brazilian Portuguese) `(bedi.com AT gmail.com)`
Maurício Arozi Moraes (More Brazilian Portuguese)
Jaume Cornadó (Catalan) `(jaumec AT lleida.net)`
Adrià Arrufat (More Catalan) `(swiftscythe AT gmail.com)`
Lin Haoxiang (Simplified Chinese) `(linhaoxiang AT hotmail.com)`
Liu Sizhuang (More Simplified Chinese) `(chinatslsz AT hotmail.com)`
Cheng Yang (More Simplified Chinese) `(yangzju AT gmail.com)`
Yen-chou Chen (Traditional Chinese) `(yenchou.mse90 AT nctu.edu.tw)`
Tryneeds-Chinese Translation Platform (More Traditional Chinese) `(tryneeds AT gmail.com)`
Lars Sommer (Danish) `(admin AT lasg.dk)`
Pascal d'Hermilly (More Danish) `(pascal AT tipisoft.dk)`
Arend van Beelen Jr. (Dutch) `(arend AT auton.nl)`
Diederik van der Boor (More Dutch) `(vdboor AT codingdomain.com)`
Jaap Woldringh (More Dutch) `(jjh.woldringh AT planet.nl)`
Elve (More Dutch) `(elve AT savage-elve.net)`
Sander Pientka (More Dutch) `(cumulus0007 AT gmail.com)`
Heimen Stoffels (More Dutch) `(djmusic121 AT gmail.com)`
Jyri Toomessoo (Estonian) `(nuubik AT hotmail.com)`
Markus Vuori (Finnish) `(markus AT vuoret.net)`
Joonas Niilola (More Finnish) `(juippis AT roskakori.org)`
Jussi Timperi (More Finnish) `(jussi.timperi AT gmail.com)`
Antony Hussi (More Finnish) `(antony.hussi AT tranciend.com)`
Choplair (French) `(pachilor AT yahoo.co.jp)`
Vincent Fretin (More French) `(fretinvincent AT hotmail.com)`
Andrea Blankenstijn (More French) `(darkan9el AT gmail.com)`
Barthe Guillaume (More French) `(gu_barthe AT yahoo.fr)`
Scias (More French) `(shining.scias AT gmail.com)`
Jan Tönjes (German) `(jan.toenjes AT web.de)`
Panagiotis Papadopoulos (More German, Greek) `(pano_90 AT gmx.net)`
Dimitrios Glentadakis (More Greek) `(dglent AT gmail.com)`
Páder Rezsõ (Hungarian) `(rezso AT rezso.net)`
Pauli Henrik (More Hungarian) `(henrik.pauli AT drangolin.net)`
David Vignoni (Italian) `(dvgn AT libero.it)`
Valerio Pilo (More Italian) `(amroth AT coldshock.net)`
Vincenzo Reale (More Italian) `(smart2128 AT baslug.org)`
Andrea Decorte (More Italian) `(adecorte AT gmail.com)`
Daniel E. Moctezuma (Japanese) `(shinsen27 AT gmail.com)`
Park Dong Cheon (Korean) `(pdc AT kaist.ac.kr)`
Øyvind Sæther (Norsk Bokmål) `(oyvind AT sather.tk)`
Zoran Milovanović (Serbian) `(provalisam AT gmail.com)`
Rastislav Krupanský (Slovak) `(ra100 AT atlas.sk)`
Matjaž Kaše (Slovenian) `(matjaz.kase AT g-kabel.si)`
Johanna Gersch (Spanish)
J.C.A. Javi (More Spanish) `(yovoya30ks AT hotmail.com)`
Alejandro Araiza Alvarado (More Spanish) `(mebrelith AT gmail.com)`
Jaume Corbí (More Spanish) `(jaume4 AT gmail.com)`
Christian Kaiser (More Spanish) `(k39 AT users.sourceforge.net)`
Juan Pablo González Tognarelli (More Spanish) `(jotapesan AT gmail.com)`
Alexis Daniel Medina Medina (More Spanish) `(alexismedina AT gmail.com)`
Manuel Ramírez (More Spanish) `(elpreto AT kde.org.ar)`
Mauricio Muñoz Lucero (More Spanish) `(real.mml AT gmail.com)`
Christian Lundgren (Swedish) `(zeflunk AT gmail.com)`
Mattias Newzella (More Swedish) `(newzella AT gmail.com)`
Rachan Hongpairote (Thai) `(rachanh AT yahoo.com)`
Gorkem Cetin (Turkish) `(gorkem AT gelecek.com.tr)`
Barbaros Ulutas (More Turkish) `(tebarul AT yahoo.com)`
Uğur Çetin (More Turkish) `(ugur.jnmbk AT gmail.com)`

Note that some translators also made other contributions.

Contributors - which without them KMess wouldn't be where it is:

Richard Conway (MSNP12 support, various patches) `(richardconway AT users.sourceforgenet)`
Guido Solinas (Pictures in contact list code, contact client info, chat font zoom) `(whereismwhite AT gmail.com)`
Pedro Ferreira (File transfer thumbnails) `(pedro.ferreira AT fe.up.pt)`
Liu Sizhuang (P4-Context field support) `(chinatslsz AT hotmail.com)`
Scott Morgan (Xinerama fixes) `(blumf AT blumf.freeserve.co.uk)`
Laurence Anderson (Original file receive patch) `(l.d.anderson AT warwick.ac.uk)`
Lin Haoxiang (file send bug fix, proxy connect code) `(linhaoxiang AT hotmail.com)`
Mohamed Aser (internationalization of file saving fix) `(mohasr AT link.net)`
Alexandre Peixoto Ferreira (Various internationalization fixes) `(alexandref AT o2.net.br)`
Choe Hwanjin (Some internationalization fixes) `(hjchoe AT hancom.com)`
Vincent Fretin (MSN6 emoticon definitions) `(fretinvincent AT hotmail.com)`
Damien Sandras (GnomeMeeting developer) `(dsandras AT seconix.com)`
Tobias Tönjes (Guy with a bag over his head)
Heimen Stoffels (updated the User Manual for version 2.0) `(cooleboy121HS AT hotmail.com)`
Andrea Decorte (Group selection in 'contact added user' dialog) `(adecorte AT gmail.com)`

Documentation copyrights:

(c) 2002 Mike K. Bennett `(mkb137b AT hotmail.com)`
(c) 2007 Diederik van der Boor `(vdboor AT codingdomain.com)`
(c) 2007-2009 Valerio Pilo `(amroth AT coldshock.net)`

This documentation is licensed under the terms of the GNU Free Documentation License.

This program is licensed under the terms of the GNU General Public License.

Appendix A. Installation
Installation

## Appendix A. Installation

## Obtaining KMess

KMess is not a part of the official KDE project.

It can be downloaded instead from http://www.kmess.org/. The download page also provides links to distributions which include KMess in their package repositories. You can usually install KMess directly with your package manager, without having to download it from the KMess website.

However, some distributions may not supply the latest version yet. In that case it is recommended to use the KMess Installer, found on top of the KMess download page.

Requirements
Requirements

## Requirements

In order to successfully use KMess, you need kdelibs-4 and qt-4 installed. At Ubuntu™ and Debian, kdelibs-4 is named kdelibs-5. KMess should be able to run on any system where kdelibs can be installed. This includes GNU/Linux®, UNIX® variants, but also Microsoft® Windows® and Mac® OS X.

To play winks, you need to have the Adobe[tm] Flash Player and CabExtract installed. See Q: 4.3.

To see a list of changes in newer versions, see:

The KMess homepage: http://www.kmess.org/
The changelog online: http://www.kmess.org/changes/
The developer weblogs: http://www.kmess.org/blogs/

The ChangeLog and NEWS file of the release should also be installed in `/usr/share/doc/packages` somewhere.

Installation
Installation

## Installation

KMess can be installed through several channels:

- The KMess Installer package

- Official packages supplied by your own distribution/vendor

- Compiled from source code

Each method has its own advantages. We recommend to use the “KMess Installer” package from our download page, as it always contains the most recent version of KMess.

To download the KMess Installer package or corresponding source code package, visit: http://www.kmess.org/download/

### Using the KMess Installer

The KMess Installer package works on every x86 Linux® system. It needs a KDE version of 4.1 or higher. Please follow the instructions to install the package. It is worth mentioning the installer has a user-friendly look.

### Installing from Source Code

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.

#### System Preparation

Before a Linux® system is able to install from source, a few additional packages need to be installed:

- make

- gcc-c++

- autoconf

- automake

- build-essential

- gettext

In many Linux® distributions, many packages have a separate “dev” or “devel” package too. Use your package-manager to find the following packages, and install them:

- qt-devel (can also be called qt4-devel)

- kdelibs-devel (can also be called kdelibs4-devel, kdelibs5-devel on Debian/Ubuntu™)

- x-devel (can also be called xfree-devel/xorg-x11-devel/xorg-devel)

- libstdc++-devel

You might need some creativity here, the package names differ slightly between Linux® distributions.

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:

- fontconfig-devel

- freetype2-devel

- libjpeg-devel

- libpng-devel

- zlib-devel

#### Extract the Source package

After you downloaded the source package, extract it with:

    $ tar zxvf kmess-2.0.tar.gz

Then navigate to the newly created directory:

    $ cd kmess-2.0/

#### Starting the Compilation

This step translates the KMess source code to an executable program. Run the following commands to compile KMess:

    $ ./configure
              $ make

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 “devel” packages.

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:

    $ ./kmess/kmess

#### Installing

It is finally possible to install! Run the following command. It will ask for your root password first.

    $ su -c 'make install'

On Debian and Debian based systems like Ubuntu™ (and all of its derivates, like Kubuntu™) use the following command:

    $ sudo make install

Alternatively, you can use Checkinstall to install the application instead. This makes it easier to uninstall KMess later. Using checkinstall, the installation becomes:

    $ su -c 'checkinstall'

Or on Debian based systems:

    $ sudo checkinstall

### Building a KMess Package

The rpmbuild command is suitable for distibutions using the RPM package format. This includes distributions like SuSE, Mandriva, Redhat and Fedora. A KMess RPM package can be created with the command:

    $ rpmbuild -tb kmess-2.0.tar.gz

The rpmbuild command runs a full source-based installation, but builds a package instead of installing KMess. The final package can be found in a subdirectory of `/usr/src/packages` or `/usr/src/rpm`. You can use that package to install KMess.

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 KMess Installer whenever possible.

Tip: when you install the autopackage-devel tools before building the RPM package, the rpm spec script uses apbuild to create a cleaner binary.