Introduction to Pidgin

Pidgin is a Gtk+ 2 instant messaging client that can connect with a wide range of networks including AIM, ICQ, GroupWise, MSN, Jabber, IRC, Napster, Gadu-Gadu, SILC, Zephyr and Yahoo!

This package is known to build and work properly using an LFS-7.9 platform.

Package Information

Pidgin Dependencies




SSL support is required for the MSN Messenger, Yahoo!, Novel Groupwise and Google Talk protocol plugins. GnuTLS is the preferred method (the Mozilla NSS API is more likely to change and this can cause problems).


Avahi-0.6.32 (required for the Bonjour plugin), Check-0.10.0 (only used during the test suite), Cyrus SASL-2.1.26, D-Bus-1.10.8, GConf-3.2.6, libidn-1.32 (required, if you wish to run the test suite), NetworkManager-1.2.0, SQLite-3.12.2 (required for the Contact Availability Prediction plugin), startup-notification-0.12, Tcl-8.6.5, Tk-8.6.5, Evolution Data Server, Farstream (Version 0.1) (required for video and voice support), Gtkspell, libgadu, Meanwhile (required for Sametime protocol support), SILC Client, SILC Toolkit, Zephyr, and MIT Kerberos V5-1.14.2 (required for Kerberos support in the Zephyr module),

Optional (runtime)


User Notes:

Installation of Pidgin

If you wish to run the test suite, make sure that libidn-1.32 is installed and remove the switch “--disable-idn”. Compile Pidgin by running the following commands:

./configure --prefix=/usr        \
            --sysconfdir=/etc    \
            --with-gstreamer=1.0 \
            --disable-avahi      \
            --disable-gtkspell   \
            --disable-meanwhile  \
            --disable-idn        \
            --disable-nm         \
            --disable-vv         \
            --disable-tcl        &&

If you have Doxygen-1.8.11 installed (Graphviz-2.38.0 can be used also) and you wish to create the API documentation, issue: make docs.

Remember the remarks before configure. To test the results, issue: make check.

Now, as the root user:

make install &&
mkdir -pv /usr/share/doc/pidgin-2.10.12 &&
cp -v README doc/gtkrc-2.0 /usr/share/doc/pidgin-2.10.12

If you created the API documentation, install it using the following commands as the root user:

mkdir -pv /usr/share/doc/pidgin-2.10.12/api &&
cp -v doc/html/* /usr/share/doc/pidgin-2.10.12/api


This package installs icon files into the /usr/share/icons/hicolor hierarchy and desktop files into the /usr/share/applications hierarchy. You can improve system performance and memory usage by updating /usr/share/icons/hicolor/index.theme and /usr/share/applications/mimeinfo.cache. To perform the update you must have GTK+-2.24.30 or GTK+-3.20.3 installed (for the icon cache) and desktop-file-utils-0.22 (for the desktop cache) and issue the following commands as the root user:

gtk-update-icon-cache &&

Command Explanations

--with-gstreamer=1.0: Remove this switch and add --disable-gstreamer if you've not installed GStreamer-1.8.1.

--disable-avahi: Remove this switch if you've installed Avahi-0.6.32.

--disable-gtkspell: Spellchecking. Remove this switch if you've installed Gtkspell.

--disable-meanwhile: Remove this switch if you've installed Meanwhile.

--disable-idn: Remove this switch if you've installed libidn-1.32.

--disable-nm: Remove this switch if you've installed NetworkManager-1.2.0.

--disable-vv: Video and voice. Remove this switch if you've installed Farstream (Version 0.1).

--disable-tcl: Remove this switch if you've installed Tcl-8.6.5.

--enable-cyrus-sasl: Use this switch if you've installed Cyrus SASL-2.1.26 and wish to build Pidgin with SASL support.

--disable-gnutls: Use this switch if you've got both GnuTLS-3.4.11 and NSS-3.23 installed, but want to use NSS-3.23 for the SSL support.

Configuring Pidgin

Config Files

~/.purple/* and ~/.gtkrc-02

Configuration Information

Most configuration can be accomplished by using the various preference settings inside the programs. Additionally, you can create a ~/.gtkrc-02 file which can store gtk+-2 theme settings that affect Pidgin and other Gtk+ 2 applications. Note that an example gtkrc-02 file was installed during the package installation and can be used as a starting point or reference.


Installed Programs: finch, pidgin, purple-client-example, purple-remote, purple-send, purple-send-async, and purple-url-handler
Installed Library:,, and
Installed Directories: /usr/include/finch, /usr/include/gnt, /usr/include/libpurple, /usr/include/pidgin, /usr/lib/finch, /usr/lib/gnt, /usr/lib/pidgin, /usr/lib/purple-2, /usr/share/doc/pidgin-2.10.12, /usr/share/pixmaps/pidgin, /usr/share/purple, and /usr/share/sounds/purple

Short Descriptions


is a text-based instant messaging client.


is a GTK+ 2 instant messaging client.


is an example that demonstrate how to use libpurple-client to communicate with purple.


send remote commands to Pidgin/Finch.


calls purple API functions using DBus and prints the return value.


calls purple API functions using DBus. As opposed to purple-send, it does not print the return value.


is a python script to handle URL with purple.

Last updated on 2016-03-30 12:27:42 -0500