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.
@set PATH=C:\QT\bin;%PATH% @set QTDIR=C:\QT @set QMAKESPEC=win32-msvc2008
QMAKE_CFLAGS_RELEASE = -O2 -MD QMAKE_CFLAGS_DEBUG = -Zi -MDd
QMAKE_CFLAGS_RELEASE = -O2 -MT QMAKE_CFLAGS_DEBUG = -Zi -MTd
It will help to escape dependencies from compiler dlls for future applications.
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
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!
And relax while QT compiling process still goes.
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:
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:
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:
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:
For user notifications:
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.