Chapter 8. Frequently Asked Questions

8.1. What does Kopete mean? How do I pronounce it?
8.2. When I have more than one messaging service under a user's name in my contact list and I click on that user's name, it will message them on the wrong messaging service.
8.3. I need to connect via a SOCKS proxy, but I cannot find any proxy configuration options in Kopete. How do I set up Kopete to use SOCKS?
8.4. Is it possible to customize the icons I see in Kopete?
8.5. I don't see any plugins listed in the “Configure Plugins” dialog. What's up?
8.6. I have many <desktops / monitors / computers> and / or I talk to many people at the same time, and as a result I wish Kopete could play a <sound / pop up a message / change my wallpaper / reboot my computer > whenever I <receive a new message / someone goes online / someone goes offline > When will this be added?
8.7. How come file transfers don't work?
8.8. Why all of this silly single-click behavior? It's very annoying!
8.9. Will you make the user-interface skinnable?
8.10. I would like a feature in the next version of Kopete.
8.11. My Kopete crashed or has/had unexpected behavior (unexpected behavior does NOT fall in the category of "Kopete doesn't act like Pidgin", etc.).
8.12. Jabber SSL support stopped working, I get the message that the QCA TLS plugin is probably missing. What am I supposed to do?
8.13. I AM behind a firewall. Which ports need to be open for WLM file transfers?
8.14. I use Jabber and ICQ together. Whenever I go online with Jabber, I am disconnected from ICQ with an error message about being connected from another client. What's up?

8.1.

What does Kopete mean? How do I pronounce it?

Kopete's name comes from the chilean word Copete, meaning a drink with your friends. Duncan, the original author, recorded an audio sample.

8.2.

When I have more than one messaging service under a user's name in my contact list and I click on that user's name, it will message them on the wrong messaging service.

You can change the order of accounts Kopete tries to message people with by using the Up and Down arrows in the bottom right corner of the account configuration screen. Kopete will try to connect with accounts starting from the top. However, if one service has a higher status value than the others for that user, Kopete will use that one. For example, if a person has three services and two are marked as away and the third is marked as online, Kopete will always try to message the user using the online service.

Tip

If you click on the small protocol icon on the right of the menu item, instead of on the person's name, you will always try to contact the person using that service!

8.3.

I need to connect via a SOCKS proxy, but I cannot find any proxy configuration options in Kopete. How do I set up Kopete to use SOCKS?

  • WLM™, ICQ™, AIM™, Jabber, and Yahoo™ use the KDE network infrastructure. Their SOCKS proxy details are configured with the rest of KDE, in System Settings, Network and ConnectivityNetwork SettingsProxy.

8.4.

Is it possible to customize the icons I see in Kopete?

You can switch between different emoticons using the Emoticons tab of the Appearance page of the Configure Kopete dialog.

To install new emoticons, first look at KDE-Look.org, where there are a lot of additional emoticon sets to download.

The emoticons are easy to install - you just place a folder containing the icon files along with an XML file describing the mapping from text to picture in $KDEDIR/share/apps/kopete/pics/emoticons (or $KDEHOME, for example, in /home/joeuser/.kde/).

  1. Copy the extracted folder to $KDEDIR/share/apps/kopete/pics/emoticons or $HOME/.kde/share/apps/kopete/pics/emoticons (or wherever $KDEHOME is)

  2. Select Configure Kopete from the Settings menu and click on Appearance in the left panel of the Preferences window and click on the Emoticons tab

  3. Select the emoticons set you just installed from the list

  4. Now you can use the newly installed emoticons in Kopete

To replace the protocol icons, you'll have to replace the icons in $KDEDIR/share/apps/kopete/icons, or provide replacements to override them in the same folder under $KDEHOME. At present there aren't any complete replacement sets that you can simply extract there.

8.5.

I don't see any plugins listed in the Configure Plugins dialog. What's up?

There are two solutions to this problem. If you used binary packages, then make sure that you used binary packages designed for your distribution, and the specific version of your distribution. Crossing distributions and versions around will not work with Kopete. If there are no binary packages for your system, you must compile Kopete using the source packages. If you compiled your KDE, then Kopete must go in the same prefix as KDE did. If, however, you compiled the source packages, then make sure that your Kopete is installed in the same location as your KDE, if it is not, you can force it to do so by specifying a prefix command to cmake. Example: cmake -DCMAKE_PREFIX=/opt/kde4 (where /opt/kde4 is your prefix). To determine where your KDE prefix is, type which dolphin in a Konsole window. It should display something like /opt/kde4/bin/dolphin, then /opt/kde4 would be your prefix, or if it says /usr/bin/dolphin, then your prefix would be /usr. Also make sure you performed a make install, and check that there is no stale Kopete installation from previous versions in different locations. You might also need to run kbuildsycoca4 manually after installing Kopete. kbuildsycoca4 updates the plugin database. It runs when new software using plugins is installed, but it is possible that kopete will run Kopete before the update has completed.

8.6.

I have many <desktops / monitors / computers> and / or I talk to many people at the same time, and as a result I wish Kopete could play a <sound / pop up a message / change my wallpaper / reboot my computer > whenever I <receive a new message / someone goes online / someone goes offline > When will this be added?

It is already there (surprise!). Kopete is a KDE application and thus makes use of KNotify for all notifications. For those who don't know, KNotify is a very powerful architecture that lets you do pretty much anything you want when an event occurs in a KDE application. You can play a sound, pop up a passive dialog, log a message, or even run your own custom commands, such as a shell script, to do anything your heart desires. To access this treasure trove, go into the SettingsConfigure Notifications dialog. This will present you with all the different actions you can take on the events listed just above. As a tip, check out some of your other KDE applications to see what events they let you catch. I for one find a passive popup on new emails in KMail to be very handy.

8.7.

How come file transfers don't work?

There are many reasons for this. WLM was the the first protocol in which we've implemented support for file transfers. Support for file transfers in Jabber and IRC was added in Kopete 0.9.0 (included in KDE 3.3), and ICQ and AIM in Kopete 0.50.0 (included in KDE 4.0.0). Also, file transfers may not work if you're behind a firewall - see WLM section in the protocol chapter.

8.8.

Why all of this silly single-click behavior? It's very annoying!

Kopete is a KDE application. We are not some lame 3rd party application that decides to "look" like the rest of KDE. We also have the "feel" and "integration" aspect of KDE, which means that Kopete follows KDE's standard "Single-click" behavior. If you would like to change this it requires you to change it in all of KDE. You can change to a double-click style by starting System Settings and go to Input DevicesMouse and change to the option Double-click to open files and folders (select icons on first click).

8.9.

Will you make the user-interface skinnable?

The only answer for this is no. Kopete was invented to be a KDE Instant-Messenger and this also includes having a KDE Look-n-Feel. By adding skins we would break this rule and having both skin-support and skinless-support at once is impractical as well. Just select a different style in KDE's System Settings and be happy to have transparent menus and other neat eye-candy today's KDE offers. You can, however, run kopete using a different style. Just run kopete --style=marble as an example. Any valid KDE or Qt™ style will work.

8.10.

I would like a feature in the next version of Kopete.

Please go to KDE Bugzilla and file a wishlist item under the application 'kopete'. Please be very detailed and proof-read what you have written to us. This is NOT a guarantee that we will add this feature in any version, but allows us to consider it.

8.11.

My Kopete crashed or has/had unexpected behavior (unexpected behavior does NOT fall in the category of "Kopete doesn't act like Pidgin", etc.).

Please report this bug to us by going to KDE Bugzilla and file a bug report under the application 'kopete'. Bugs will only be accepted if they are in English, they are detailed, and if a crash was involved they contain a backtrace (the text in the tab marked Backtrace once Kopete has crashed). If you are using Kopete git, however, please mail us at Kopete developers mailing list instead of filing a bug report.

8.12.

Jabber SSL support stopped working, I get the message that the QCA TLS plugin is probably missing. What am I supposed to do?

As the error message indicates, you are missing the QCA TLS plugin, which handles the Jabber plugin's TLS/SSL encryption. Install the package qca-tls (and eventually qca-ossl) or retrieve the plugin from its homepage. Please note that you only need to install the qca-tls plugin, not the QCA library itself. A recompilation of Kopete is not necessary, in fact not even a restart. In case you have installed the plugin and it still won't work, Qt can probably not find it. Since qca-tls installs itself as a Qt™ plugin, you will have to make sure that it gets installed to the plugin directory of the Qt™ version you are using to run Kopete.

8.13.

I AM behind a firewall. Which ports need to be open for WLM file transfers?

If you are behind a firewall, port 6891 needs to be open to inbound TCP traffic.

8.14.

I use Jabber and ICQ together. Whenever I go online with Jabber, I am disconnected from ICQ with an error message about being connected from another client. What's up?

Remember when you played with ICQ transports on that other Jabber client? You set up an ICQ Transport which allows you to talk to ICQ people from Jabber. ICQ doesn't allow multiple connections to the same account, and disconnects you. Look in your Jabber contacts for a contact of the form 123456@icq.jabber.org and delete it.