!SECTION Compiling and Installing
Q: Why can't I compile Pidgin?
A: Make sure you have relatively recent versions of automake, autoconf,
and gettext. HOWEVER, generally speaking, having the absolute newest of
them is not as good as having one version short of newest since we might
not have found work-arounds for the latest set of changes. Also, some
versions of automake require certain ranges of gettext versions, and we are
utterly unable to keep track of what versions will work with what other
If you have Slackware < 9.1, you need to get non-slack packages for autoconf,
automake and libtool. You also have to copy the contents of
<code>/usr/local/share/aclocal</code> to <code>/usr/share/aclocal</code>. This is due to bugs in
Slackware and the auto* packages.
*BSD users may also have problems with libtool and will also have to remove
the <code>--no-verify</code> from the configure script.
Having problems getting SSL and MSN working? See
<a href="./faq-ssl.php">these notes</a> for distribution specific hints.
Q: I'm trying to install Pidgin, but it complains that I don't have
<code>libgtkspell.so.0</code>, from where can I get this?
A: <code>libgtkspell.so.0</code> is provided by gtkspell. This library is used by
Pidgin to provide the "Highlight misspelled words" feature. You can find an
RPM of gtkspell at <a href="http://freshrpms.net/">freshrpms.net</a>. You
can find the source and a non-Red Hat specific RPM at <a
href="http://gtkspell.sourceforge.net/">gtkspell.sourceforge.net</a>.
Q: What do I need to use the SILC protocol?
A: You need to install the
<a href="http://silcnet.org/software/download/toolkit/">SILC toolkit</a>
and the Pidgin SILC plugin. This plugin is generally provided as a
separate package (such as a purple-silc RPM). If you're compiling yourself,
see the <code>./configure --help</code> for specifying the SILC includes and libs.
If you're compiling an SRPM, use <code>--with silc</code> to build the
In Windows, the SILC toolkit is installed with Pidgin.
Some distributions provide the SILC toolkit and include Pidgin's
SILC plugin in their Pidgin package.
Q: Is there some way I can compile just Pidgin, without all of these protocols?
A: Yeah. There are actually three ways to do it.
Use the <code>--with-static-prpls</code> option to <code>./configure</code> along with
<code>--disable-plugins</code>. This will let you choose which protocols are compiled in
with Pidgin, but you will not be able to use any other protocols or plugins.
You'll need to compile any protocols that you specified in
<code>--with-static-prpls</code>. Oscar is the default.
Use the <code>--with-dynamic-prpls</code> option to
Change to the directories for the protocols you
want to compile (e.g. <code>src/protocols/jabber</code>), and
run <code>make</code> from there. Then after you've compiled all of
them, change back to <code>src/</code> and run <code>make pidgin</code>.
Q: I installed a new version of Pidgin, but the about window says I'm
still using the old version.
A: If you compiled yourself, and you previously had an RPM or a
Debian package installed, you need to remove that first.
<code>rpm -e pidgin</code> or <code>dpkg -p pidgin</code> should work.
Likewise, if you want to use an RPM or deb and you have previously
compiled Pidgin from source, you need to <code>make uninstall</code> to
remove all Pidgin files from <code>/usr/local</code>.
Q: Are the packages signed? If so, by who, and how can I get the key?
A: Yes, all packages are signed. The signature for the
tarball and bzip2 archive are provided by separate downloads. The RPMs
we provide are signed by either Ethan Blanton, Mark Doliner, or Stu
Tomlinson. Usually the Mandrake RPMs are signed by, Mark Doliner, the
Fedora Core RPMs are signed by Stu Tomlinson, and the Red Hat 8 and 9 RPMs
are signed by Ethan Blanton.
The keys can be obtained from any key server.
<a href="http://pgp.mit.edu/">http://pgp.mit.edu/</a> is popular.
Q: Can I run Pidgin on IRIX?
A: Sure you can - the amount of effort involved depends on which compiler you use;
there is however no official support.
GCC (tested with 3.4 on IRIX 6.5.29):
All but one necessary changes were included in the official sources.
You will notice GnuTLS will not be included by default, even if the necessary
includes and libraries are available; to add SSL support, open the configure script
in your favourite editor and replace all instances of "-lnsl" by "-lnsl -lgnutls".
Ask no questions :-) it Just Works. Mozilla-NSS wasn't tested.
MIPSPro CC (tested with 7.4.4m on IRIX 6.5.29):
Less trivial for obvious ANSI-tightness reasons. There's an unofficial patch for
<a href="http://jesuschrist.be/gaim/gaim-2.0.0beta3_irix.patch">here</a>, which
applies (amongst others) the SSL hack described above. You will need to configure
WITHOUT the Zephyr protocol plugin.
NOTE: Jabber crashed Pidgin when using TLS. This is a bug inside GnuTLS that might
or might not be fixed by the time you read this.
Q: Can I run Pidgin on HPUX?
A: Yes, you can; with GCC 4.1.1 on HPUX 11.11 at least it worked fine.
There is however no official support.
The build scripts that are shipped with the "official" releases
are unfortunately incompatible with the HPUX linker; fetching the svn version and
running autogen.sh however gives you a healthy build dir. Configure Pidgin WITHOUT
the X screensaver extension and disable the gtk- and glibtests; no source hacks are needed.
Q: Can I run Pidgin on MacOSX?
A: Yes you can, but we do not provide a package for it. The reason
being that in order to use Pidgin on MacOSX, you need to install an X server and
GTK+, which we are not prepared to support. You can either compile Pidgin
(and its dependencies) yourself, or you can use the fink installer
available from <a href="http://fink.sf.net">http://fink.sf.net</a>. If you
would like a native aqua interface or a user-friendly installer, we
suggest trying <a href="http://www.adiumx.com/">Adium</a>.
Q: How do I apply the patch "something.diff"?
A: Type <code>patch -p0 < something.diff</code> from inside the
Pidgin directory. If that doesn't work, try <code>patch -p1 < something.diff</code>.
Q: Why is Pidgin crashing when I start it?
A: First of all make sure you are using the most recent version of
Pidgin. If you still have problems, try the following:
Make sure only one version of Pidgin is installed. "whereis pidgin"
can sometimes be useful for determining this.
"export GDK_USE_XFT=0" in a terminal and then run Pidgin from the same
Try disabling or deleting any 3rd party plugins, especially anything
<li>If you use 0.75 or higher on win32, try deleting <code>tcl.dll</code>.</li>
Q: Pidgin <non-current version> is buggy. Pidgin SVN is buggy. Why?
A: Non-current versions have old bugs which may be fixed in the
current version--that's why we make new releases. SVN is
frequently unusable because of changes in the code. Bugs are
introduced during the development process and are hopefully fixed
before a release is made.
Q: Why do you always say not to use SVN?
A: That's a long story. For starters, see the previous question.
It is often the case that Pidgin SVN exhibits bad behavior due to
features and bugfixes which are in a transitory state or which are not
yet well understood. These bad behaviors range from the harmless
(maybe a graphical glitch in a dialog box) to the irritating (a
particular protocol may not work), to the downright damaging (recently
a bug in SVN destroyed the user's buddy lists). While behaviors like
this are acceptable to some users (particularly developers, who are
used to such things), they tend to cause many Pidgin SVN users to
contact Pidgin developers and report the same (usually egregious) bug
over and over - using time which could be better spent fixing the
A second major point involves public resources - an SVN checkout is not
a cheap operation. As many Sourceforge users are aware, at various
points in the recent past Sourceforge CVS has been less than pleasant
to work with. This is, of course, because Sourceforge hosts dozens
and dozens of useful and active projects which use[ed] CVS as a primary
method of source code collaboration. Unfortunately, when too many
users are poking around in that CVS just for the sake of poking
around, it prevents other users who are trying to do work to improve
those very same projects from accomplishing their tasks. Naturally,
this could easily become true of Sourceforge's SVN offering as well.
It is better for the community if an enterprising individual wishing
to fix a particular bug [s]he has seen can get to the code and create
a patch, even if this means that some users have to wait a few weeks
for the next release to see what new features it might hold.
The third point is not a problem which has yet come up, but it is in
the back of the mind of the developers who bring you Pidgin. As a
third-party IM client, Pidgin is not a priority (and indeed may be an
irritant) for the IM service providers. We do our best to keep Pidgin
playing nice and being friendly on the IM networks it uses; however,
at times there are bugs in the protocol support. If a few dozen
people are using this buggy client, the IM providers are not likely to
go out of their way to do anything about it. However, if hundreds of
people are pointing an ill-behaved client at an IM server, the server
administrators may be forced to take action. (This is particularly
likely if the buggy behavior is damaging in some way.) Pidgin releases
represent code which the Pidgin developers feel is relatively
well-behaved and stable. This includes not only the interface seen by
Pidgin users, but the traffic seen by IM service providers. Pidgin SVN
bears no such guarantees.
In short, there are a lot of good reasons to <i>not</i> use
Pidgin SVN if one does not wish to develop Pidgin, Pidgin plugins, or a
codebase which interacts with Pidgin in some intimate way. There are,
however, only a few reasons <i>to</i> use Pidgin SVN outside of the
above. Please weigh these things carefully and decide whether you
wish to use Pidgin SVN for a good reason which furthers the community, or
for selfish reasons which are not entirely important.
Q: How do I register for a new account?
A: This depends on the protocol.
<p><b>AIM:</b> Go to <a href="http://my.screenname.aol.com/_cqr/login/login.psp?siteId=snshomepage&authLev=1&mcState=initialized&createSn=1">this website</a>.</p>
<p><b>MSN</b> (including Hotmail email)<b>:</b> Go to <a href="http://registernet.passport.com/">http://registernet.passport.com/</a>.</p>
<p><b>MSN</b> (using your own email address)<b>:</b> Go to
<a href="http://register.passport.net/">http://register.passport.net/</a>.</p>
<p><b>Yahoo:</b> Go to <a href="http://edit.yahoo.com/config/eval_register">http://edit.yahoo.com/config/eval_register</a>.</p>
<p><b>Jabber:</b> See the question <a href="#jabber-register">How do I register a new Jabber account?</a> below.</p>
<p><b>ICQ:</b> Go to <a href="http://web.icq.com/register">http://web.icq.com/register</a>.</p>
<p><b>Gadu-Gadu:</b> Use the official client to create an account.</p>
<p><b>Novell:</b> See your Novell server administrator.</p>
Q: How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
A: Use the Account Editor (Accounts->Add/Edit) to add the account of
the appropriate messaging service. Use the checkbox in the account editor to
Q: How do I use Google Talk?
A: Create a Jabber account as per <a
href="http://www.google.com/support/talk/bin/answer.py?answer=24073">Google's
FAQ</a>. The Audio component is not currently supported and will not be
until work on it is finished. We have no time frame for that as yet.
Q: How do I change the font Pidgin uses? The empty left padding? The
A: The font preference in Pidgin is used only for the formatting of outgoing
messages. The display fonts used by the rest of Pidgin are those specified
by GTK+. To change this font you need to edit your <code>~/.gtkrc-2.0</code>
file. If you need help you can see our example
<a href="./gtkrc-2.0"><code>.gtkrc-2.0</code></a> file. On Windows, this file
is located at <code>C:\Documents and
Settings\username\.themes\Default\gtk-2.0\gtkrc</code>. If the file does not
You can also just switch to a different GTK+ theme. You can find GTK+ themes
(and information on using them) by visiting
<a href="http://themes.freshmeat.net/">themes.freshmeat.net</a>,
<a href="http://art.gnome.org/">art.gnome.org</a>, or searching on Google.
<p>Similarly, the other font preferences are the defaults for outgoing
messages, and Pidgin's global settings are controled by the gtk theme.
Additionally, some settings to specific parts of Pidgin can be set by a Gtk+
Q: Where did my ability to use Ctrl-Enter to send a message go?
A: Pidgin used to have an option in the preferences window which let you
choose whether to use Enter or Ctrl-Enter to send a message. This was less than
optimal for many reasons, not least of which was because it only let you
choose between those two options. It also caused large problems for people
who required an alternate input method (people who were typing in Chinese or
Japanese for example). On top of all this gtk provides an incredibly nice
mechanisms which allows keybindings to be set for things via the gtk theme
files. Pidgin decided to use this gtk interface as a method of allowing
people to use Ctrl-Enter to send but to also allow people to use anything else
they felt like and to reduce the clutter in the User Interface. The gtk
interface is, unfortunately, not as immediately obvious as a simple checkbox,
however it is still simple. The example gtkrc file seen
<a href="./gtkrc-2.0">here</a> shows you how to do it (among other things).
Q: When I click the status selector, I see blank space and have to
scroll. What can I do about this?
A: Edit your <code>~/.gtkrc-2.0</code> to contain the appropriate lines
from <a href="./gtkrc-2.0">this example file</a>. Search for "appears-as-list".
Q: The status selector has extra padding in it. How can I make it smaller?
A: Edit your <code>~/.gtkrc-2.0</code> to contain the appropriate
lines from <a href="./gtkrc-2.0">this example file</a>. Search for
"xthickness". There are two examples. Start by trying the first one. If that
makes the status selector look worse, then try the second one.
Q: How do I make Pidgin use emacs-like keybindings, or assign a custom
A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the appropriate
lines from <a href="./gtkrc-2.0">this example file</a>. If you are using
<code>gtk-can-change-accels = 1</code>, then you hover over the menu item then
press your desired key stroke.
Q: How do I make Escape close the conversation window?
A: Sadly, you can't use the hover-and-press technique just described
for this, because Escape closes the menu. You have to hand-edit
<code>~/.purple/accels</code>. Close Pidgin, and open
<code>~/.purple/accels</code> in your favorite text editor. Find
<code>(gtk_accel_path "<main>/Conversation/Close"
"[something]")</code>, remove the semi-colon (which is the comment
character) from the start of the line if it is there and replace whatever
is between the second pair of quote marks with <code>Escape</code>. Save
and close, and restart Pidgin.
Q: How do I use smiley themes?
A: To select a theme, open Pidgin's preferences to the "Smiley Themes"
page and click on whichever theme you want to use. To install a
theme, simply drag it into the theme selector. You can find themes
href="http://sourceforge.net/tracker/?atid=746976&group_id=235&func=browse">Pidgin Smiley Themes</a> tracker.
You can also install themes manually by uncompressing them to their own
directory in ~/.purple/smileys/
Q: Why are the status icons so big?
A: We believe that, by adding a second line of text to each buddy list
entry, we're able to show more information about each buddy on the buddy
list. The 'Big List,' as we call it, shows status text and idle time
concisely and attractively. It shows more than one status
"emblem" for each buddy, indicating at the same time a mobile user who is
away. Most importantly, it puts the buddy icon in the list, making it far
easier to locate buddies within a large list where names are harder to pick
out than images. Due to the increased usability of this interface, we
have made it the default.
We are aware that some people feel more comfortable using an interface
more similar to IM clients they may have used in the past. The 'Big List'
can be disabled by un-checking "Show buddy details" in the Buddies menu.
Q: Why do the emblems move around the status icon?
A: The four corners of the icon have different precedence. The lower-right
is the highest, lower-left is second-highest, etc. The most important emblem
is in the lower-right, always. When an AOL buddy is not away, the fact that
[s]he's an AOL user is the most important information shown in the icon. The
consistency is that the user can always look in the same place on the icon to
find out what he needs to know. Also, importantly, the lower-right corner
emblem is the only emblem that shows up when "Small list" is on, as only one
Q: How do I get sound to work correctly?
A: Pidgin uses gstreamer to play sounds. Playing sounds
directly through esound or arts is no longer supported.
To compile Pidgin with support for gstreamer you need libgstreamer0.10-dev
and its dependencies. If you do not wish to install these packages you
can also just change your sound playing method in preferences to
<code>Command</code> and use <code>esdplay %s</code> or
<code>artsplay %s</code>.
Q: How do I make Pidgin use ALSA or OSS for playing sounds? What does the
A: The "Automatic" option lets gstreamer pick how the sounds are played.
You can use the <code>gstreamer-properties</code> tool to control this.
Q: Why does Pidgin use the same <code>WM_CLASS</code> for every window? It makes
it impossible to control window size and placement for the buddy list
separately from the conversations.
A: Both strings in the <code>WM_CLASS</code> property are supposed to be the
same for all windows in the same instance of an application. ICCCM states that
one is meant to be the same for all instances of the application, the other is
meant to be unique to that instance of the application. ICCCM also states "If
a client has multiple windows with identical <code>WM_CLASS</code> and
<code>WM_NAME</code> properties, then it should provide a
<code>WM_WINDOW_ROLE</code> property."
Gtk+ sets these <code>WM_CLASS</code> values for us so that they are unique
for Pidgin instances, and the documentation for the
<code>gtk_window_set_wmclass</code> function says explicitly not to use it
for anything else. Pidgin uses the <code>WM_WINDOW_ROLE</code> hint to
differentiate windows. If your window manager is having problems
differentiating between Pidgin windows, please ensure that it uses the
<code>WM_WINDOW_ROLE</code> hint per the ICCCM.
Q: I blocked someone accidentally, how can I unblock them?
A: See the "Privacy" option under the "Tools" menu of the Buddy List.
Q: What is a "Buddy Pounce"?
A: Pidgin introduced buddy pounces a few releases before AOL came out with
"Buddy Alerts." Despite this though, you could think of a buddy pounce as an
Alert and get an idea of the most minimal uses of a buddy pounce. In reality,
a buddy pounce is much like a macro, or a recorded action. When you set a
pounce on someone, you choose from a number of events, such as sign on or
someone going away, and then you choose from a number of actions. These
actions include everything from playing a sound (like an Alert would do) to
sending a message to the person, to executing a command. This action will
occur the next time Pidgin detects the event, ie the next time the person in
your buddy list who you have pounced signs on.
Q: Where does Pidgin store its logs?
A: On unix, they are in <code>~/.purple/logs</code>, on win32 they are in the
<code>C:\Documents and Settings\user\Application Data\.purple\logs</code>
directory. (NOTE: <code>Application Data</code> is a hidden directory.) In
either case, new logs (new as of 0.73) are in subdirectories that correspond to
protocol/yourscreenname/theirscreenname.
Q: Can I use Pidgin for e-mail, blogging, an RSS feed, or something else
A: No, you can't. We get requests for this often, but Pidgin is indeed a
messaging client. Aside from the capabilities each protocol may
support, the Pidgin developers have no intention to turn Pidgin into a
multi-feature Internet client capable of doing everything under the sun. We
also won't be helping to develop plugins to turn it into that. There are
many Internet applications available for Linux, Windows, or whatever
operating system you use that would undoubtedly do a better job.
Q: Does Pidgin support file transfer?
A: Somewhat, yeah. As of 2.0.0 beta 5 The following is supported:
<li>Sending and receiving files on AIM</li>
<li>Sending and receiving files on ICQ</li>
<li>Sending and receiving files on IRC</li>
<li>Sending and receiving files on Jabber</li>
<li>Sending and receiving files on MSN</li>
<li>Sending and receiving files on SILC</li>
<li>Sending and receiving files on Yahoo when not using an HTTP proxy (sending
is limited to an unknown file size)</li>
Most of the protocols themselves support file transfer, but Pidgin
has not been written to support it yet. If you would like file transfer
to work better or be more complete, check out a copy of Pidgin SVN and submit a patch!
Q: Can I turn the tray icon off?
A: Sorry, no. The tray icon will load if you have a Notification Area.
Q: What do those colors in the conversation tab mean?
<li><b>Red</b> - A message is waiting for you</li>
<li><b>Blue</b> - Someone sent a message containing your name</li>
<li><b>Green</b> - The buddy is typing</li>
<li><b>Yellow</b> - The buddy began typing, and then stopped</li>
<li><b>Gray</b> - There has been a join or a part in that chat,
or the buddy has signed off</li>
Q: Can I import or export my buddy list?
A: The plugin pack hosted at <a
href="http://guifications.sourceforge.net/PluginPack" title="Pidgin Plugin
Pack">http://guifications.sourceforge.net/PluginPack</a> has a plugin to
Q: Does Pidgin support animated smileys?
A: Yes, but there is a bug which can cause animation to be lost if
Pidgin has to resize the image.
Q: Can I make Pidgin group screen names by the person that owns them? You
know, like Trillian's Meta Contacts?
A: Sure! Right click a buddy on your list and at the bottom of the menu click
"Expand". Then just drag other screen names to the same person below it. When
you're done, click on the arrow to collapse them. When the contact is
collapsed, Pidgin will select a buddy to display based on the status of the
buddies in the contact, and their order.
You may need to turn off the preference option to automatically expand
Contacts in order to be able to edit an existing Contact.
Q: What happened to my timestamps? Can I change them?
A: As of 2.0.0, timestamps follow the system locale. This is a
significant difference from previous versions of Pidgin, and though it was
requested more than once, we know it will prove to be a controversial
decision. Fortunately for all of you out there, we also provide plugins
As of 2.0.0, there are two plugins that relate to timestamps. One, the
"Timestamp" plugin, has existed for some time. It allows you to have
iChat style timestamps, though implemented to behave slightly
differently. The other plugin is new. The "Message Timestamp Formats"
plugin allows you to manipulate your timestamps in a couple different
ways. Notably, you can restore the 1.x timestamp format, and/or cause
all timestamps to have dates in them.
Q: How does Pidgin decide which saved statuses to show in the status
A: Pidgin shows six "popular" saved statuses in the status selector.
These are your six most recently used statuses, offset by a weight.
Pidgin sorts all your saved statuses by the timestamp when they were
last used. And then, for each time you've used a status, the
timestamp is increased by one day.
If you are upgrading from 1.x or lower, Pidgin is unable to determine which
are the most popular states, as these older releases did not save that
information. As a result, the initial contents of the menu will be
somewhat random. It will settle over the first few uses of (distinct)
states into the behavior described above.
Q: Why are no states listed when I go to set a state for Auto Away?
A: Pidgin can only use saved states for this feature. You need to create
and save a named state first.
!SECTION AIM/ICQ (OSCAR) Protocol
A: In AIM, yes, you can. Go to Accounts-><i>account name</i>.
Set your ICQ profile is not supported yet.
Q: Can I set a buddy icon?
A: Yes. Go to the Account Menu, and click to "Modify" the AIM/ICQ account you
wish to have an icon. Enter the full path to the image you wish to use in the
box labeled "Buddy Icon File." The file must be smaller than 4KB. It can have
any dimensions, and can be in any format. However, if you wish Windows users
to see it, it must be in a format Windows understands, such as .bmp, .gif, and
Q: I just changed my buddy icon, and I can't see the new one.
A: First, try IMing yourself a few times. Buddy icons are checked
when you IM people, so depending on the protocol, that may work.
If it still doesn't update, check the file size (buddy icons must
be smaller than 4kb) and the image size (it should be 48x48 or
50x50 in most cases). Also, check the file type. GIF or JPEG images
are best supported; most other formats do not work at all. If all
of that checks out and it still doesn't work, and you're sure the
protocol supports it, try restarting Pidgin.
Q: Some of my buddies are not showing up as online, why is that?
A: AOL has set a limit for the maximum number of people you can have in
your buddy list. This number is currently 500 for AIM, if you don't think
you are anywhere near that limit, it is possible that your server-stored buddy
If you think this might be the case, you can try signing on with an
official AIM program from AOL. This will usually correct any problems
Q: Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
A: Yes, you need to register purple-url-handler in your browser. This
requires that Pidgin be built with dbus support.
Q: Does Pidgin support DirectIM and IM Image?
A: Yes, absolutely. Keep in mind that you must establish a DirectIM
session before you're able to insert a picture into the conversation.
Q: Can I send SMS messages?
A: Yep, just send an IM to the person's phone number. For example,
if the phone number is (919) 555-1234, you would message
+19195551234 We think this should work for countries with a country
code of 1 (the United States and Canada).
Sending SMS messages using "the ICQ method" is not yet supported.
Q: Can I add SMS numbers to my buddy list?
A: Yes. You should be able to add phone numbers to your buddy
list using the same format as above.
Q: How do I join a channel with the IRC plugin?
A: Create an IRC account and then sign on. After you have signed on, you
can use Buddies->Join A Chat on the buddy list to join a channel. In any
window, either a conversation or a chat, in which your IRC user is the
sender, you can also use <code>/join</code> to connect to a new channel.
Q: Is there a way to make Pidgin automatically identify me and/or join IRC
A: Yes. Add NickServ to your buddy list and place buddy pounces on
him/her/it. Do not include "/msg nickserv" as part of the
In version 0.64 or higher, you can add a chat to your buddy list, right click
it, and tell Pidgin to auto-join it.
Q: Is it possible to change the user name that appears in
A: Yes. Go to the Accounts menu. Select your IRC account and click
to edit. Click the Advanced tab. Enter a name in the Username field.
Q: How can I set/change my real name?
A: Go to the Accounts menu. Select your IRC account and click to edit.
Click the Advanced tab. Enter a name in the Real name field.
Q: How do I choose which Jabber server to use?
A: The Jabber server name is part of your Jabber I.D., such as
<code>somebody@server.name</code>. So when entering your Jabber "screen
name", the server is specified as part of your JID.
Q: How do I change my Jabber resource to be other than the default of "/Home" (or the old default of "/Pidgin")?
A: In the buddy list window, click the Accounts menu. Next, find
your Jabber account and click Edit Account. Change the value in the Resource
field. Click Save. Note: This setting cannot be changed while the account
Q: Can I remove a buddy from my Jabber roster entirely?
A: With Pidgin 0.60 or later, the deletion code will do this.
Pidgin currently does not retain invisibility settings between logins,
just as it doesn't currently retain "away" status.
Q: What does "Cancel Presence Notification" do?
A: This selection, available in Pidgin version 0.60 and later, and found by
right-clicking on a buddy entry in the buddy list, prevents that
Jabber I.D. from receiving future presence notifications when you log on to
After you do this, that buddy will have to re-request a subscription to
your presence (and you will have to approve it) for them to again see you
!SECTION Y!M (Yahoo) Protocol
Q: I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why
doesn't Pidgin have Yahoo's "Firewall with no proxy" option?
A: Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping
the YMSG protocol inside HTTP. Pidgin currently doesn't support doing this.
Pidgin does support changing the port it connects to. Try changing the
Pager Port in the Account editor under "Show more options". Ports
known to work are: 20, 23, 25, 80, 119, 5050, 8001, and 8002. While this
doesn't work for as many people as actually tunneling through the HTTP
protocol would, it helps many users.
Q: I blocked someone, but it doesn't seem to have worked.
A: As of 0.81, this is a known bug in our Yahoo code. We're not sure
what exactly is wrong, but it seems to fail most often when automatically
removing the buddy from your buddy list at the same time it blocks them.
It also always seems to fail if Pidgin already thinks the buddy is blocked,
and you try to block them again.
We suggest manually removing Yahoo! buddies before attempting to block them.
For buddies which Pidgin reports are blocked but which are not, unblocking them
and reblocking them from the Tools->Privacy dialog will often get things
Q: Can I get a list of Yahoo! Chat rooms? What about localized lists?
A: Tools->Room List will let you list available Yahoo! Chat rooms.
Yahoo! has currently disabled user-created rooms. The option to create rooms
still exists in Pidgin but is non-functional unless Yahoo! re-enables
Yahoo! does support hidden and invite-only rooms. If you know the name of the
room you wish to join, and it's not invite only, you can join it via
Buddies->Join a Chat. You can also create a chat room this way, although we
don't support setting the hidden or invite-only type settings.
Please note that defaults to US localized chat rooms. To get a localized room
list, you'll need to change the Chat Room Locale setting in the account editor,
under "Show more options". In previous releases, this was known as "Chat Room
List URL". The URL is no longer used; it has been replaced by a country code.
These codes are the same as the country codes previously used in the URLs.
Certain country codes no longer seem to work (most notably de).
The list of known country codes is:
<li>ar => Argentina</li>
<li>au => Australia</li>
<li>cf => Central African Republic</li>
<li>dk => Denmark</li>
<li>hk => Hong Kong</li>
<li>kr => Korea, Republic of</li>
<li>sg => Singapore</li>
<li>uk => United Kingdom</li>
<li>us => United States of America</li>
If you discover any of these no longer work, or find other country codes that do work, please don't hesitate to contact the development team. (See the <a href="./contactinfo.php">Contact Information</a> page.)
Q: What protocol does Pidgin use to connect to Yahoo!?
A: Normally Pidgin uses the YMSG protocol, which is the same protocol that
the official Yahoo! clients use. If an attempt to login returns the "Invalid
Password" error code, Pidgin automatically tries to log in using the "Web
Messenger" method. This method still uses the YMSG protocol, but authenticates
differently, and connects to a different server.
While in Web Messenger mode, several things work differently or not at all.
Adding, moving, and removing buddies doesn't work, and the only available
statuses are "Available" and "Invisible". In addition, the Yahoo! server seems
to ignore all Yahoo! Chat related packets. For this reason, we use the YCHT
protocol to join Yahoo! Chat rooms while connected using the Web Messenger
Q: Will Pidgin support MSN video chat?
A: See <a href="#vv">this question</a>.
Q: Why are my file transfers so slow?
A: Pidgin only supports tranferring files over MSN via the MSN
servers. This means all your data is sent to an MSN server
and then forwarded to the person at the other end of the
transfer. It is unknown whether we will support true peer
to peer file transfer over MSN.
Q: Is there a way to invite more than one person to an MSN chat?
A: Yes. Right click a buddy on your list and choose "Initiate Chat". In the
conversation window that appears, choose "Invite" from the "Conversation" menu
to invite another user. When the conversation framework gets another rewrite,
it is possible that this will be simplified.
Q: Is MSNP11 (MSN7) going to be supported?
A: It is being worked on.
Q: Why can't I sign on to MSN?
A: You probably did not compile Pidgin with SSL support, or the SSL
load. The MSN protocol requires the use of SSL,
which Pidgin provides by either GnuTLS or the combination of NSS and NSPR
from the Mozilla project. Install one or both of these and recompile Pidgin,
and see the next question.
Q: The MSN plugin won't load, but I have Mozilla NSS!
A: Some distributions, including Slackware, install Mozilla NSS to a
non-standard directory. The fix is simple. Edit <code>/etc/ld.so.conf</code>
and add <code>/usr/lib/mozilla-1.4</code> (or whatever version you're using,
but it's usually 1.4) to the file, and run ldconfig as root. Then re-run
configure and recompile Pidgin. You may also need to specify where the include
file are for NSS and NSPR, see <code>./configure --help</code> for the options.
Mozilla 1.5 has a broken .pc file and does not install the necessary .h files,
and so will not be detected.
See <a href="./faq-ssl.php">these notes</a> on getting SSL to work with Pidgin.
Q: What does "MSN: S: 911 3" in the debug window mean when I cannot
A: See <a href="./911.txt">this explanation</a>.
Q: How do I set an MSN avatar?
A: Pidgin calls these Buddy Icons. Go to Tools->Accounts and click to Modify
your MSN account. You can drag and drop a file to the resulting dialog, or use
Q: What does "Has you" in the buddy tooltip mean?
A: It shows you if that MSN user has added you to his/her buddy list.
"Has you: No" does <i>not</i> mean you can't talk to that person.
Q: How do I set my MSN Friendly Name (the name other users see)?
A: In the Buddy List window, go to Accounts-><i>account</i>->Set
Q: What does "Error reading from switchboard server" mean?
A: We haven't fully figured that out yet, but even Microsoft's client seems
to get similar errors, although with less frequency than we do. See <a
href="http://sourceforge.net/tracker/index.php?func=detail&aid=1060205&group_id=235&atid=100235">
Bug 1060205</a> for further information.
!SECTION Gadu-Gadu Protocol
A: Gadu-Gadu is an IM protocol popular in Poland. You can find more about
it at <a href="http://www.gadu-gadu.pl/">www.gadu-gadu.pl</a>
Q: I compiled Pidgin from source and now it doesn't have Gadu-Gadu
A: We now use an external libgadu. Install your distro's libgadu-dev
or libgadu-devel package and rebuild Pidgin (making sure to rerun
<code>./configure</code>). If your distro doesn't provide libgadu, you can download it from
<a href="http://toxygen.net/libgadu/files/libgadu-1.7.0.tar.gz">http://toxygen.net/libgadu/files/libgadu-1.7.0.tar.gz</a>.
Unpack the tarball and run:
<pre><code>./autogen.sh --prefix=/usr --disable-libgadu-openssl --disable-static --enable-shared
su -c "make install"</code></pre>
A: Zephyr is an IM protocol developed at MIT for use with Project Athena. Its
features include Kerberos IV authentication, multi-level chats (aka
"subscriptions"). You're probably using this because your
college/employer/organization uses it as a local IM/chat system. If not,
you probably don't have a server to connect to.
Q: Other Zephyr clients (zwgc, owl, tzc) work, but Pidgin dies with "Couldn't
A: Your site might require the use of Kerberos 4 for authentication, though
few prepackaged Pidgin binaries use Kerberos. One solution is to compile Pidgin
with the --with-krb4 flag to point to the location of your Kerberos 4 devel
files, usually one of <code>/usr</code>, <code>/usr/local</code>, or
<code>/usr/athena</code>, e.g.
<code>./configure --with-krb4=/path/to/kerberosIV</code>
Q: Pidgin isn't working, but I never got any other Zephyr client working on this machine.
A: You need to have zhm (which comes with the standard Zephyr distribution)
installed, and running, and pointed at your Zephyr servers. e.g.
<pre><code>zhm z1.example.com z2.example.com z3.example.com</code></pre>
Alternatively, there might be a firewall or a NAT between you and the
Zephyr servers. Zephyr generally doesn't work in an environment where incoming
connections cannot be made to arbitrary UDP ports.
Q: How do I use Zephyr from behind my firewall, or without recompiling with kerberos support if needed?
A: You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a
machine that is behind a firewall or NAT. First, make sure that tzc is
installed and working on the remote machine. The best version of tzc to use
<a href="http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/tzc-cclub_001-3.tar.gz">here</a>.
Second, make sure that you can make a passwordless ssh connection to the remote
machine and get kerberos 4 tickets.
Then, click on "Show more options", enable "Use tzc", and set the tzc command to
<pre><code>/path/to/ssh username@hostname /path/to/tzc -e "%s"</code></pre>
Alternately, if you have tzc working on your machine, you can enable "Use tzc",
and set the tzc command to <pre><code>/path/to/tzc -e "%s"</code></pre>
A: SILC is an open protocol designed from the ground up with security in
mind. It is, or should be, the protocol of choice for the paranoid. See
<a href="http://www.silcnet.org">http://www.silcnet.org</a> for more details.
Q: Are there any public servers for Novell?
A: Not really. This protocol is designed to connect to a Novell GroupWise
server running on a corporate LAN.
Q: I can't seem to get it to work.
A: Novell tells us that this protocol plugin will only work with either
the GroupWise Messenger for Linux server or the GroupWise Messenger SP2
(or higher) server for NetWare and Windows. In addition, the server must
be secure (SSL enabled). If you have any trouble, see the FAQ question
about submitting bugs, and they will be forwarded to Novell, who have
been kind enough to continue active maintenance to the protocol plugin
!SECTION Scripts and Plugins
Q: How do I use perl scripts with Pidgin?
A: Save the perl script to <code>~/.purple/plugins/</code> or
<code>$prefix/lib/purple/</code>, restart Pidgin, and load the perl script
by checking the check box next to its name in the Plugins dialog.
Q: How do I compile a plugin for Pidgin?
A: To compile a plugin for Pidgin, you must have Pidgin's source code.
To download Pidgin's source code, get the most recent tarball from
<a href="./downloads.php">http://www.pidgin.im/downloads.php</a>
and untar it with the command: <code>tar zxvf <i>filename</i></code> where
<i>filename</i> is the file you downloaded.
After you have a Pidgin source code tree:
Change to the resulting directory and run the command:
<code>./configure</code> This will create the necessary make files.
Move the plugin you wish to compile into the <code>plugins/</code>
directory in the Pidgin source code tree.
Change to the <code>plugins/</code> directory.
<p>On Unix/Linux Type:</p>
<pre><code>make <i>name</i>.so</code></pre>
<p>where the name of the file you wish to compile is <i>name</i>.c.</p>
<pre><code>make -f Makefile.mingw <i>name</i>.dll</code></pre>
<p>where the name of the file you wish to compile is <i>name</i>.c.</p>
Note well the difference in the extensions. If you type <code>make
<i>name</i>.c</code> instead of <code><i>name</i>.so</code>, it won't work.
After <code>make</code> finishes, you can move the plugin to a place that is
more convenient. <code>$prefix/lib/purple</code> is suggested. If you
installed Pidgin by compiling it yourself, <code>$prefix</code> is
<code>/usr/local</code> by default. Otherwise, <code>$prefix</code> is
Q: I have a plugin or perl script for Pidgin that used to work, but does not
with the current version.
A: The plugin and perl script API has changed several times, which means
plugins and perl scripts must be modified in order to work. The plugin or
perl script must be located in <code>$prefix/lib/purple/</code> or in
<code>~/.purple/plugins/</code>,
and must implement the new API, as documented by the <code>make docs</code>
command from the root of the Pidgin source code tree. This will generate
html documentation in the <code>doc/html</code> directory. Also note that plugins and perl scripts are now controlled from a separate Plugins dialog.
Q: Where can I find documentation on writing plugins and Perl scripts?
A: If you look in the <code>plugins/</code> directory in the Pidgin source,
you should see a HOWTO file with some details for C plugins. Also be sure
<a href="./api/index.html">online documentation</a>.
Be especially sure to look at the Related Pages, which lists all of Pidgin's
signals, as well as a nice perl script HOWTO.
This documentation can be generated directly from the Pidgin source by
running <code>make docs</code>. You will need doxygen and graphviz
dot installed for this to work.
A: Yes! We especially need small patches for small bugs, and lots of
bug triaging. There are a slew of a bug reports in Pidgin's bug report
tracker - you could pick one and try to tackle it and submit a patch.
Bug triaging is when you look at a bug report and determine whether it
is a duplicate of an earlier report, or whether it is user error, or
maybe you need to request additional information to be able to reproduce
the bug. SourceForge won't let random users modify the settings on bugs,
but if you leave helpful comments we can go through and make the
href="http://sourceforge.net/tracker/?func=browse&group_id=235&atid=100235">Dig
Q: Pidgin never leaves a core file.
A: On most installs core files are limited in size to 0 bytes, and are
therefore not created. To rectify this situation, add
<code>ulimit -c unlimited</code> to your startup scripts (<code>~/.bash_profile</code>
is a good place) or run it manually in a terminal before starting Pidgin
from that terminal. You can also run Pidgin directly in gdb with
Q: Will you support features such as voice chat, internet phones, or
A: We hope to add voice and video support in Pidgin 3.0.0. We don't
have a timeline for when this will be finished. Voice and video is
a very time intensive feature, and many of the core group of Pidgin
developers are very busy. <a href="#contribute">Help ease their
Q: Where should I report bugs?
A: <a href="./bug.php">Here</a>.
Q: Where should I submit patches?
A: <a href="./patches.php">Here</a>.
Q: Did you guys reverse engineer it?
A: Jabber, MSN and IRC are published protocols, so we
didn't have to reverse engineer those. Oscar, ICQ, and Yahoo are not
published, and were reverse engineered by other people. Novell was
provided by Novell, and SILC was written by one of the developers of
!SECTION Miscellaneous Questions
A: Sure! Look at the <a href="./contactinfo.php">Contact Information</a> page!
A: We don't know how to answer this question. Stop asking it.
Q: Does Pidgin support secure instant messaging (encrypted IMs)?
A: Short answer: Yes, use the SILC protocol.<br/>
Long Answer (for other protocols): Not natively. Doing secure instant messaging right is a big deal and
requires, among other things, an authentication scheme. Simply encrypting
your data stream without verifying the party with whom you are chatting is
not secure in any way; some other clients offer options like this, but we
feel that such measures instill a false sense of security that is more
There are a number of 3rd party plugin developers
working on developing a secure IM framework. See the
<a href="plugins.php">Plugins</a> page for links.
!ANCHOR plaintext-passwords
Q: Why are the passwords in accounts.xml not encrypted?
A: This is a case of a really long answer to a short question.
<a href="./plaintextpasswords.php">Read our explanation here</a>.
Q: When will the next version of Pidgin be released?
A: The schedule for releases is every third Thursday. However, a new
version will only be released if it meets a certain standard of quality
(i.e., it will not be released if it still has a large number of serious
bugs). Therefore, some releases will take longer than others. Major
rewrites means lots of new bugs to work out. The new version will be
released as soon as it is possible to do so.
Q: What will the next version be?
A: Starting with version 1.0.0, Pidgin version numbers have 3 parts to them.
The format is major.minor.micro. If we change something internally in Pidgin
such that some plugins won't work with the newer version, we will increment
the major version number. If we don't increment the major version number,
and we've added things to the Pidgin API that won't break any older stuff, we
will increment the minor version number. In any other cases, we will
increment the micro version number. Even and odd numbers have nothing to do
with stability, and you should always be running the latest release of Pidgin
to get new features and bug fixes.
Q: So, can I look forward to mega-sexy super functionality with Pidgin?
A: Yes, that is the intended idea. In fact, there have been quite a number
of unpopular geeks who have made the switch to Pidgin. In a matter of days,
the number of dates and awesomeness points received by the geek increased
ten fold! You, too, can have an exciting life with Pidgin. Get Pidgin. Get
the babes. Get uhh... hmm.
Q: How do I change the language for the Highlight Misspelled words option?
A: Pidgin currently only supports spell checking in your locale language.
This is because gtkspell 2 does not offer a good way for us to know which
dictionaries are available or to switch between them. This functionality has
long been promised for gtkspell version 3, which has been delayed somewhat
indefinitely. See <a href="http://gtkspell.sf.net">gtkspell.sf.net</a>.
Q: Can I make Pidgin transparent/translucent?
A: You can make Pidgin translucent in most versions of Windows using
the "Transparency" plugin. It is not possible to make Pidgin
translucent in Linux and other platforms that use X11.
X.org provides a COMPOSITE extension that allows
applications to have true translucency, but it is X.org-specific
and it requires support at the GTK+ level (if it is to be
per-widget). We do not wish to support this form of translucency
until it is supported by GTK+. We also do not wish to implement
the psuedo-translucency offered by other programs (by copying
a section of your background image, tinting it, and plastering
it onto a Pidgin window).
A: The UI can be customized using GTK themes. Read <a
href="http://www.pidgin.im/skins.php">this</a> for more information.
!COMMENT vim: syntax=gaimfaq tw=75
