Frequently Asked Questions (FAQ)

First, you should choose the way of installation. There are four common ways.

The first way is preferred for novice users, who don't know how to install software. You just have to ask your favorite guru to help you with this.

Second way is preferable for the users of Mac OS X, Windows and package-based Linux systems. Just go to the http://qutim.org/downloads and http://qutim.org/nonstable page and find out where to download and how to install package for your OS.

Third way would be used by unlucky users who haven't found packages for their distribution, or by those geeks who like to compile packages themselves (and don't look at me, I'm not pointing at Slackwarriors!). If you are such user, go to the http://qutim.org/downloads page, download there fresh sources and issue similar commands in the directory where the source tarball is:

tar -xvf qutim_0.1.1.tar.gz
cd qutim_0.1.1
qmake-qt4 -config release qutIM.pro && make
cd build/bin
./qutIM

Of course, you should replace qutim_0.1.1 with your version number. Please, remember, that you won't be able to build qutIM, if you don't have Qt 4 (version 4.3.0 or higher) development headers installed.

Think carefully, do you really want it? I don't think so, you'd better to go and download binary version. Otherwise, you know how to build it yourself, without help from my side. For example, we will use MSVS 2008 with Visual C++ 9.00 compiler and Qt 4.4. Why MSVS and not MinGW? There are some reasons for this choise: binaries which built with MSVS have smaller size and higher performance.

1. Download QT sources from Trolltech site. Follow this link to download package «qt-win-opensource-src-x.y.z.zip» (x.y.z - actual version of QT).
2. Install MSVS2008 on your PC. Use google for more information about this step.
3. Unpack your zip file with Qt. For example, we will use folder «C:\QT»
4. Copy vsvars32.bat file (You can find it in MSVS Tools dir) to C:\ (Just example)
5. Open text editor and add the folowing lines to beginning

   @set PATH=C:\QT\bin;%PATH%
   @set QTDIR=C:\QT
   @set QMAKESPEC=win32-msvc2008

6. Open C:\QT\mkspecs\win32-msvc2008/qmake.conf
   Edit from

   QMAKE_CFLAGS_RELEASE = -O2 -MD
   QMAKE_CFLAGS_DEBUG = -Zi -MDd

   to

   QMAKE_CFLAGS_RELEASE = -O2 -MT
   QMAKE_CFLAGS_DEBUG = -Zi -MTd

   It will help to escape dependencies from compiler dlls for future applications.

7. Open cmd and type:

   cd C:\
   vsvars32
   cd C:\QT
   configure.exe -release -static -no-exceptions -no-accessibility -no-qt3support -qt-gif -qt-libjpeg -no-dsp -no-vcproj -no-rtti -no-style-plastique -no-style-cleanlooks -no-style-motif -no-style-cde

   It is just sample of configuring options, see

   configure.exe --help

   for details. Also you can tweak your Qt configuration by editing C:\QT\src\corelib\global\qconfig.h. But this option doesn't support by Trolltech, use at your own risk!

8. Type

   nmake

   And relax while QT compiling process still goes.

9. Now you may compile qutIM: (Don't repeat previous 8 steps each time when you are going to build qutIM). Unpack sources qutIM to C:\qutIM (just another example). Open cmd and type

   cd C:\
   vsvars32
   cd qutIM
   qmake -win32 -nocache -o Makefile qutIM_static.pro
   nmake

   Don't use UPX or another compressors for exe files! else your binary would «eat» too many memory! I use SFX archives created with 7z.

Check in the following order:

• If you have gcc/g++ installed?
• If you have X-server and its development headers installed?
• If you have QT 4 (version 4.3.0 or higher) and its development headers installed?

There is a common question: «Can I run qutIM on Solaris (QNX, HP-UX, IRIX, Nokia N800, programmable calculator Elektronika MK-152 and so on)?». The answer is simple: yes, if you have port of QT 4.4 to your OS. If you can compile QT 4.4 for your uncommon hardware or OS, I'm sure you can do the same with qutIM. Let's run qutIM on each calculator!

You are unlucky, sorry, dude. qutIM uses QT anywhere, not only in GUI, and I think there are no geeks who want to rewrite it. Yep, you can find util QGTKStyle, which makes your QT theme similar to the GTK one. But you will never pure obtain GTK interface in it. I'm really sorry.

Currently we are not providing wide access to SVN. The problem is that we often store unstable or non-compileable code there, so many users start crying and sending us undesired messages about they can't compile it, or find a lot of bugs there, or something else. So, only beta-testers and special people, who really know, how to build packages and report problems, are allowed to build unstable versions from svn. If you want to build packages for your OS or to become beta-tester, you probably could join our team. Try it.

qutIM supports oficially only ICQ protocol. XMPP(Jabber) and Mail.Ru in test mode for now.

Your qutIM configuration is stored in the `~/.config/qutim/` folder. Local protocol configs can be found in `~/.config/qutim/qutim.XXXXXXXXX/` folders, where `XXXXXXXXX` is your profile name.

You can install five types of addons:

• themes for tray notification
• smile-packs
• additional styles
• status themes from Adium
• sound-packs

First four types you can install system-wide (for all users usage) or locally. If you are installing them system-wide or from package, traythemes, smile-packs, styles, status themes should be placed in `/usr/share/qutim/traythemes/` , `/usr/share/qutim/emoticons/`, `/usr/share/qutim/styles/` and `/usr/share/qutim/StatusIcons/` respectivelly. If you are installing them for you own usage, place them into `~/.config/qutim/traythemes/`, `/.config/qutim/emoticons/`, etc. folders. For instance, if you want install Kolobok smiles for system-wide usage, the path to the theme xml file must be something like `/usr/share/qutim/emoticons/kolobok/emoticons.xml`. Please, mention that you mustn't place theme just in `emoticons` folder, create special folder for it inside! NB: in Debian folders `/usr/share/qutim/emoticons/`, `/usr/share/qutim/traythemes/` etc. are symlinked to the `/var/lib/qutim/emoticons/`, `/var/lib/qutim/traythemes/` etc. respectivelly. It is made corresponding to the new FHS rules, so Debian local administrators should place system-wide themes in `/var/lib/` rather than `/usr/share/`. Also qutIM support portable configuration if folder `./config/qutim` exists (path from folder, where situated qutIM binary)

If you are installing soundpack, you can place folder with sounds anywhere. Then go to your configuration and import xml scheme in sounds configuration (see Configuration section somewhere below).

You can easily find them in the specialized qutIM forum: http://qutim.org/forum/viewforum.php?f=33. Smile-packs installation see above. After installation choose the pack for usage in the configuration dialogue of the qutIM (Smiles section). Also you can make your own smile-pack, see below.

If you want to create your own theme, you'll have to create a directory with the name of the theme, for example: Kolobok. Next, you place all smile images in that directory. It should be pointed out, that only GIF smiles currently can be animated. JPG, PNG and BMP are definitely NOT, and APNG is not understood by QT, it draws only first frame. MNG hasn't been tested but I assume it also isn't supported. Finally you should write file `emoticons.xml` in that directory. It has definite structure, which is shown below.

<?xml version="1.0"?>
<messaging-emoticon-map>
   <emoticon file="aa">
      <string>O:-)</string>
      <string>O=)</string>
      <string>O:)</string>
      <string>O+)</string>
      <string>0:-)</string>
      <string>0=)</string>
      <string>0:)</string>
      <string>0+)</string>
   </emoticon>
   <emoticon file="ab">
      <string>:-)</string>
      <string>:)</string>
      <string>=)</string>
   </emoticon>
</messaging-emoticon-map>

Let's look at the example. Header always should be same. String `<emoticon file=«aa»>` points, that image with the name `aa` will be described. Extension of the file usually is not written, so don't place files aa.gif and aa.jpg in the same folder, it can produce mistakes! Next you have a number of `<string>` sections which are used for pointing, which string should be replaced with this smile. You may write as many emoticons as you want, but more smiles - more memory usage. Remember it.

Traythemes can be found in the specialized qutIM forum: http://qutim.org/forum/viewforum.php?f=35 Traythemes installation see above. After installation choose the theme for usage in the configuration dialogue of the qutIM (Notifications section). Also you can make your own traytheme, see below.

If you want to create your own theme, you'll have to create a directory with the name of the theme, for example: Chlorine. Next, you place 3 folders inside: `msg`, `onlalert` and `system`. `msg` folder is used for notification about incoming messages, `onlalert` - for all other user notifications, `system` - for all system notification. In each folder should be placed two html-files: `header.html` for the header of notification and `content.html` for notification body. Also you can place `header.css` and `content.css` with the stylesheets. List of all html-tags and styles, supported by QT you can find on the following pages:

• http://doc.trolltech.com/4.4/richtext-html-subset.html
• http://doc.trolltech.com/4.4/stylesheet.html

If you place any additional data, which is targeted in theme, the %path% should be placed before it. For example, if your use in your `msg` notifications background image `bg.gif`, place it in `msg` folder and refer to it as %path%/msg/bg.gif You can use next keywords in notifications (they'll be replaced with the corresponding values): For system notifications:

• %path% - path to the theme folder
• %minenick% - your nick
• %message% - message

For user notifications:

• %path% - path to the theme folder
• %minenick% - your nick
• %message% - message
• %fromnick% - nick of the contact, whick is mentioned in notification
• %avatar% - path to that contact avatar

Sounds can be found in the specialized qutIM forum: http://qutim.org/forum/viewforum.php?f=34 For installation of the soundpack unpack it in some folder, then in the Configuration dialogue of qutIM in the Sounds section click Import and choose the .xml file from the folder where you unpacked the pack. Theoretically, you can unpack soundpack anywhere, but we recommend you to create in `/usr/share/qutim/sounds/` (or in `/var/lib/qutim/sounds/`, according to the new FHS specifications) or in `~/.config/qutim/sounds/` a special folder for each soundpack.

Just select a sound for each event in a Sound section of the Configuration dialogue of qutIM. Then, click Export and save .xml file in some folder.