Difference between revisions of "Pidgin"

From ArchWiki
Jump to navigation Jump to search
m (add zn-CN translation)
(→‎Services: Add google hangouts)
 
(127 intermediate revisions by 46 users not shown)
Line 1: Line 1:
[[Category:Internet Applications]]
+
[[Category:Instant messaging]]
 
[[Category:Internet Relay Chat]]
 
[[Category:Internet Relay Chat]]
 +
[[Category:XMPP]]
 
[[de:Pidgin]]
 
[[de:Pidgin]]
 
[[es:Pidgin]]
 
[[es:Pidgin]]
 +
[[fr:Pidgin]]
 +
[[ja:Pidgin]]
 
[[ru:Pidgin]]
 
[[ru:Pidgin]]
[[zh-CN:Pidgin]]
+
[[zh-hans:Pidgin]]
'''Pidgin''' (formerly Gaim) is an instant messaging client for Linux that can connect to many different IM networks, such as Live Messenger, Yahoo, IRC, AIM, etc. One of Pidgin's key features is that you can use many networks at the same time.
+
[http://www.pidgin.im/ Pidgin] is an easy to use and free chat client used by millions. Connect to Google Talk, ICQ, IRC, XMPP, and more chat networks all at once.
  
==Installation==
+
== Installation ==
[[pacman|Install]] {{Pkg|pidgin}}, available in the [[Official Repositories]].
 
  
You may also want to [[pacman|install]] additional plugins from the {{Pkg|purple-plugin-pack}}.
+
[[Install]] the {{Pkg|pidgin}} package.
 +
Notable variants are:
 +
* {{App|Pidgin Light|Light Pidgin version without GStreamer, Tcl/Tk, XScreenSaver, video/voice support.|http://pidgin.im/|{{AUR|pidgin-light}}}}
  
==Spellcheck==
+
You may also want to install additional plugins from the {{Pkg|purple-plugin-pack}}.
Aspell will be installed as a dependency, but to prevent all of your text from showing up as incorrect you will need to install an aspell dictionary:
 
# pacman -S aspell-en
 
  
This installs the English dictionary. Use {{Ic|pacman -Ss aspell}} to list available languages.
+
== Spellcheck ==
  
{{Note| The '''switch spell'''-plugin is included in the purple-plugin-pack (see above). It allows you to switch between multiple languages.}}
+
The {{pkg|aspell}} package will be installed as a dependency, but to prevent all of your text from showing up as incorrect you will need to install an aspell dictionary. See the [[aspell]] article.
  
==Sound fix==
+
{{Note|The '''switch spell''' plugin is included in the {{Pkg|purple-plugin-pack}}. It allows you to switch between multiple languages.}}
To have event sounds working, install the {{pkg|gstreamer0.10-good}} package. Alternatively, in the "Sounds" preferences tab, the method can be set to 'command' and one of the following sound commands used.
 
  
After configuring [[ALSA]]:
+
== Services ==
aplay %s
 
  
If using [[OSS]]:
+
=== AIM ===
ossplay %s
 
  
==Browser error==
+
Pidgin has out-of-the-box support for AOL Instant Messenger (AIM). Although AIM has officially ceased, unofficial AIM-based servers like [http://iwarg.ddns.net/aim/ AIM Phoenix] operate and can be used on Pidgin by changing the server address in the AIM protocol account settings.
If clicking a link within Pidgin creates an error message about trying to use 'sensible-browser' to open a link, try editing {{ic|~/.purple/prefs.xml}}. Find the line referencing 'sensible-browser' and change it to this:
+
 
<pref name='command' type='path' value='firefox'/>
+
=== Discord plugin ===
 +
 
 +
Install the {{AUR|purple-discord-git}} package.
  
This example assumes you use [[Firefox]].
+
Then add a new account, select Discord as the protocol, enter your Discord login e-mail address and its password.
  
==QIP Encoding bug==
+
=== Facebook ===
There is another bug in character encoding when communicating between Pidgin and QIP, which especially affects Czech language, but there are also other languages affected. There are two possible solutions. The better one is to upgrade from QIP to QIP Infimum, second solution is to install and enable plugin from {{AUR|pidgin-qip-decoder}} package currently available from [[AUR]].
 
  
==IRC==
+
[[Install]] the {{Pkg|purple-facebook}} package. (or {{AUR|purple-facebook-git}})
This is a small tutorial for connecting to Freenode. It should work for other IRC networks as long as you substitute the port numbers and other specific settings.
 
  
Go to Accounts -> Manage Accounts -> Add -> Fill/select the following options:
+
Then add a new account, select Facebook as the protocol, enter your [https://www.facebook.com/help/211813265517027 Facebook username] and password and login.
Protocol: IRC
 
Username: <your username>
 
  
Now go to Buddies -> New instant message ( or hit ctrl + m) fill 'freenode.net' in the textbox and <username>@irc.freenode.net -> then click 'Ok'. Type:
 
/join #archlinux (channel is irrelevant)
 
  
In order to register your nick, type:
+
=== Google (Hangouts) ===
/msg nickserv register <password> <email-addres>
 
  
Follow the instructions from the registration mail. For further help type:
+
[[Install]] the {{AUR|purple-hangouts-hg}} package.
/msg nickserv help
 
/msg nickserv help <command>
 
  
This final step will add your channel to 'Buddies': go to Buddies -> Add chat -> fill the correct channel in the textbox named channel (#archlinux).
+
=== ICQ ===
  
==Xfire==
+
Pidgin has out-of-the-box support for ICQ. Since December 2018, the old OSCAR protocol is no longer officially supported as it has been replaced by the newer WIM protocol. Currently, Pidgin only comes with the original OSCAR ICQ protocol. To make use of the new WIM protocol on ICQ, you should install the {{AUR|purple-icyque-git}} plug-in.
Simply install {{Pkg|pidgin-gfire}} and then add a new account, selecting xfire as protocol.
 
  
==Facebook XMPP==
+
=== IRC ===
Since Facebook Chat supports XMPP, you can use Pidgin without extra plugins. See this article for more information: [http://blog.facebook.com/blog.php?post=297991732130 Facebook Chat Now Available Everywhere]
 
  
{{Note| In order to utilise facebook chat through XMPP and pidgin, you will require a facebook "username", this is located in facebook -> account settings -> username [below real name]}}
+
This is a small tutorial for connecting to Freenode. It should work for other IRC networks as long as you substitute the port numbers and other specific settings.
  
1. Go to "Accounts" and select "Manage Accounts."
+
Go to ''Accounts > Manage Accounts > Add''. Fill/select the following options:
 +
Protocol: IRC
 +
Username: ''your username''
  
2. On the Basic tab, enter the following info:
+
Now go to ''Buddies > New instant message'' (or hit {{ic|Ctrl+m}}), fill 'freenode.net' in the textbox and ''username''@irc.freenode.net, then click 'Ok'. Type:
: Protocol: XMPP
+
/join #archlinux
: Username: ''Your facebookID'' (without e-mail domain, e.g. @yahoo.com, etc)
+
The channel is irrelevant.
: Domain: chat.facebook.com  (make sure you haven't typed any extra space)
 
: Resource: Pidgin (leave this empty if you get "username@chat.facebook.com/Pidgin Not Authorized" error message)
 
: Password: ''Your Password''
 
: Local alias: ''Your Name''
 
  
3. Click the Advanced tab, then enter the following info:
+
In order to register your nick, type:
: Connect port: 5222
+
  /msg nickserv register ''password'' ''email-addres''
: Connect server: chat.facebook.com (make sure you haven't typed any extra space)
 
: (Uncheck the box labeled "Require SSL/TLS")
 
  
{{Note| Newer versions of Pidgin do not have a "Require SSL/TLS" box. Instead, select "Use encryption if available" from the Connection Security dropdown in Advanced}}
+
Follow the instructions from the registration mail. For further help type:
 +
/msg nickserv help
 +
  /msg nickserv help ''command''
  
{{Note| Changing your facebook privacy settings to "Turn off all apps" (under Apps and Websites), will disable your ability to send messages via jabber.}}
+
This final step will add your channel to 'Buddies': go to ''Buddies > Add chat'', fill the correct channel in the textbox named channel (#archlinux).
  
== Privacy ==
+
=== Sametime protocol ===
Pidgin has some privacy rules set by default. Namely, the whole world cannot send you messages; only your contacts or people selected from a list. Adjust this, and other settings through:
+
 
Tools -> Privacy
+
[[Install]] the {{AUR|libpurple-meanwhile}} package. The 'Sametime' protocol will be available when creating an account.
  
=== Pidgin-OTR ===
+
=== SIP/Simple protocol for Skype for Business/Office 365/Lync ===
This is a plugin that brings Off-The-Record (OTR) messaging to Pidgin. OTR is a cryptographic protocol that will encrypt your instant messages.
 
  
First you need to install {{Pkg|pidgin-otr}} from [extra], like so:
+
[[Install]] the {{AUR|pidgin-sipe}} package.
# pacman -S pidgin-otr
 
  
Once this has been done, OTR has been added to Pidgin.
+
=== Skype plugin ===
  
To enable OTR, start Pidgin and go to Tools -> Plugins or press Ctrl + U. Scroll down to the entry entitled "Off-The-Record Messaging". If the checkbox beside it is not checked, check it.
+
Install the {{Pkg|purple-skypeweb}} or {{AUR|purple-skypeweb-git}} package.
  
Next, click on the plugin entry and select "Configure plugin" at the bottom. Select which account you wish to generate a key for, then click "Generate". You will have now generated a private key. If you are not sure what the other options do, leave them, the default options will work fine.
+
=== Slack plugin ===
  
The next step is to contact a buddy who also has OTR installed. In the chat window, a new icon should appear to the top right of your text input box. Click on it, and select "Start private conversation". This will start an 'Unverified' session. Unverified sessions are encrypted, but not verified - that is, you have started a private conversation with someone using your buddy's account who has OTR, but who might not be your buddy. The steps for verification of a buddy are beyond the scope of this section; however, they might be added in the future.
+
Install the {{AUR|slack-libpurple-git}} package.
  
=== Pidgin-Encryption ===
+
=== Rocket.Chat plugin ===
Pidgin-Encryption transparently encrypts your instant messages with RSA encryption. Easy-to-use, but very secure.
 
# pacman -S pidgin-encryption
 
  
You can enable it the same way as Pidgin-OTR.
+
Install the {{AUR|purple-rocketchat}}{{Broken package link|package not found}} package.
  
Now you can open conversation window and new icon sould appear beside menu. Press it to enable or disable encryption.
+
=== Telegram plugin ===
Also if you want to make encryption enabled by default right-click on a buddy's name (in your buddy list), and select Turn Auto-Encrypt On. Now, whenever a new conversation window for that buddy is opened, encryption will start out as enabled.
 
  
== Sametime protocol ==
+
Install the {{AUR|telegram-purple}} or {{AUR|telegram-purple-git}} package.  
Sametime support is not available in the default version of Arch Linux's Pidgin package. This section will demonstrate how to enable this feature via AUR and the 'Meanwhile' plugin. This section assumes that you are familiar with using the AUR and that you are performing the following commands in {{ic|~/builds}} directory.
 
  
First install [https://aur.archlinux.org/packages.php?ID=2956 meanwhile] from the [[AUR]].
+
Enter your Telegram phone number when creating the account, after which you will receive an SMS text message with a confirmation code, which you'll have to enter to authorize your Telegram protocol account on Pidgin.  
  
Now you have to rebuild your installed version of Pidgin with Sametime support: the procedure is different depending on whether you have Pidgin from [extra] or from a package in AUR.
+
=== XMPP ===
  
===[extra] package===
+
Pidgin has out-of-the-box support for the XMPP/Jabber chat protocol. Some additional plugins exist on the AUR for support of XMPP extensions such as OMEMO ({{AUR|libpurple-lurch}}) or Message Carbons ({{AUR|libpurple-carbons}}).
  
Make sure you have installed the [[Arch Build System]] and downloaded the ABS tree.
+
== Security ==
  
Now copy the pidgin directory of ABS to {{ic|~/builds}}:
+
Pidgin uses Libpurple 2 which stores passwords unencrypted (in plaintext) in $HOME/.purple/account.xml, see [https://developer.pidgin.im/wiki/PlainTextPasswords]. You can store them in a keyring by using a plugin like:
$ cp -r /var/abs/extra/pidgin ~/builds
 
  
Go to {{ic|~/builds/pidgin}} and edit the {{ic|PKGBUILD}} file. Go to the {{Ic|build()}} section and make sure you remove the {{Ic|--disable-meanwhile}} line from the configure options.
+
* {{AUR|purple-gnome-keyring}}
 +
* {{Pkg|pidgin-kwallet}}
  
Make the package:
+
== Privacy ==
$ makepkg -s
 
  
Install '''first''' the libpurple package as root:
+
Pidgin has some privacy rules set by default. Namely, the whole world cannot send you messages;
# pacman -U libpurple-version-arch.pkg.tar.gz
+
only your contacts or people selected from a list. Adjust this, and other settings in ''Tools > Privacy''.
  
After that install the pidgin package as root:
+
=== Pidgin-OTR ===
# pacman -U pidgin-version-arch.pkg.tar.gz
 
  
Pidgin now has the 'Sametime' protocol as an option when creating accounts.
+
This is a plugin that brings Off-The-Record (OTR) messaging to Pidgin. OTR is a cryptographic protocol that will encrypt your instant messages.
  
===AUR package===
+
First you need to install {{Pkg|pidgin-otr}} from the official repositories. Once this has been done, OTR has been added to Pidgin.
  
Download and extract your Pidgin package from AUR (this example will use pidgin-gnome, change to preference):
+
# To enable OTR, start Pidgin and go to ''Tools > Plugins'' or press {{ic|Ctrl+u}}. Scroll down to the entry entitled "Off-The-Record Messaging". If the checkbox beside it is not checked, check it.
$ cd ~/builds && wget https://aur.archlinux.org/packages/pidgin-gnome/pidgin-gnome.tar.gz && tar xfvz pidgin-gnome.tar.gz
+
# Next, click on the plugin entry and select "Configure plugin" at the bottom. Select which account you wish to generate a key for, then click "Generate". You will have now generated a private key. If you are not sure what the other options do, leave them, the default options will work fine.
 +
# The next step is to contact a buddy who also has OTR installed. In the chat window, a new icon should appear to the top right of your text input box. Click on it, and select "Start private conversation". This will start an 'Unverified' session. Unverified sessions are encrypted, but not verified - that is, you have started a private conversation with someone using your buddy's account who has OTR, but who might not be your buddy. The steps for verification of a buddy are beyond the scope of this section; however, they might be added in the future.
  
Change into the extracted directory:
+
=== Pidgin-Encryption ===
$ cd pidgin-gnome
 
  
In order to have 'Sametime' support you must remove the following from PKGBUILD
+
{{AUR|pidgin-encryption}} transparently encrypts your instant messages with RSA encryption. Easy-to-use, but very secure.
--disable-meanwhile
 
  
Build the package:
+
You can enable it the same way as Pidgin-OTR.
$ makepkg -s
 
  
Install the package as root:
+
Now you can open conversation window and new icon should appear beside menu. Press it to enable or disable encryption.
# pacman -U pidgin-gnome-2.5.8-1-i686.pkg.tar.gz
+
Also if you want to make encryption enabled by default right-click on a buddy's name (in your buddy list), and select Turn Auto-Encrypt On. Now, whenever a new conversation window for that buddy is opened, encryption will start out as enabled.
  
Pidgin now has the 'Sametime' protocol as an option when creating accounts.
+
=== Pidgin-GPG ===
  
== SIP/Simple protocol for Live Communications Server 2003/2005/2007 ==
+
Pidgin-GPG transparently encrypt conversations using GPG, and taking advantage of all the features of a pre-existing WoT.
  
The [https://aur.archlinux.org/packages.php?ID=16170 pidgin-sipe] plugin is available from [[AUR]].
+
The plugin is available on AUR as {{aur|pidgin-gpg-git}}. It can be enabled the same way as the previously mentioned ones.
  
 
== Other packages ==
 
== Other packages ==
 +
 
Arch has other Pidgin-related packages. Here are the most popular (for a thorough list, search the AUR):
 
Arch has other Pidgin-related packages. Here are the most popular (for a thorough list, search the AUR):
 
*{{Pkg|pidgin-libnotify}} - Libnotify support, for theme-consistent notifications
 
*{{Pkg|pidgin-libnotify}} - Libnotify support, for theme-consistent notifications
*{{Pkg|guifications}} - Toaster-style popup notifications
+
*{{AUR|purple-libnotify-plus}} - Notifications with Libnotify which does work with notify-osd. It might matter for WMs without DE, like i3, the original pidgin-libnotify instead uses plain messagebox there.
*{{AUR|microblog-purple}} - Libpurple plug-in supporting microblog services like Twitter
+
*{{Pkg|guifications}}{{Broken package link|package not found}} - Toaster-style popup notifications
*{{AUR|pidgin-light}} - All supported protocols same as default;  but without gstreamer, tcl, tk or xscreensaver support.  No video/voice.
+
*{{AUR|pidgin-latex}} - A small latex plugin for pidgin. Put math between $$ and have it rendered (recepient also needs to have this installed)
  
==Skype plugin==
+
== Auto logout on suspend ==
  
Install {{AUR|skype4pidgin}} from the [[AUR]].
+
If you suspend your computer pidgin seems to stay connected for about 15 minutes. To prevent message loss, it is needed to set your status offline before suspending or hibernating. The status message won't be changed.
  
==Auto logout on suspend==
+
Therefore create a new systemd unit {{ic|pidgin-suspend}} in {{ic|/etc/systemd/system}}
 +
Take the following snippet and replace ''myuser'' with your user.
  
If you suspend your computer pidgin seems to stay connected for about 15 minutes. To prevent message loss create a {{ic|00pidgin}} file in {{ic|/etc/pm/sleep.d/}} to set your status to offline before suspending or hibernating. The status message won't be changed. Take the following script and replace {{ic|''user''}} with your user.
+
[Unit]
  #!/bin/sh
+
Description=Suspend Pidgin
  #
+
Before=sleep.target
# 00pidgin: set offline/online status
+
StopWhenUnneeded=yes
 +
 +
[Service]
 +
Type=oneshot
 +
User=''myuser''
 +
  RemainAfterExit=yes
 +
Environment=DISPLAY=:0
 +
ExecStart=-/usr/bin/purple-remote setstatus?status=offline
 +
  ExecStop=-/usr/bin/purple-remote setstatus?status=available
 
   
 
   
  case "$1" in
+
  [Install]
  hibernate|suspend)
+
  WantedBy=sleep.target
DISPLAY=:0 su -c 'purple-remote setstatus?status=offline' ''%user''
 
;;
 
thaw|resume)
 
DISPLAY=:0 su -c 'purple-remote setstatus?status=available' ''%user''
 
;;
 
*) exit $NA
 
;;
 
esac
 
  
== Troubleshooting ==
+
== Minimize to tray ==
 +
To make use of the [[Xfce]] system tray go to preferences and enable the system tray in the section "Interface".
 +
You can now close the main window and run pidgin minimized. You will also be able to see message notifications in the tray.
  
*If facebook XMPP verification does not work for you, there a package in the aur [https://aur.archlinux.org/packages.php?ID=34479 pidgin-facebookchat] which does not require a unique user name (you may login with an email address)
+
== History import Kopete to Pidgin ==
  
*The facebookchat plugin will prompt for varification (enter these two words...), if that fails, hit cancel and log onto facebook with pidgin open, this will configre the plugin's security setting)
+
* Install {{Pkg|xalan-c}} and create {{ic|~/bin/history_import_kopete2pidgin.sh}} with this code:
 
+
{{bc|<nowiki>
=== Installing Pidgin After a Carrier Installation ===
 
* If you previously installed [https://aur.archlinux.org/packages.php?ID=17191 Carrier] (aka [http://funpidgin.sourceforge.net/ FunPidgin]), follow these steps ''before'' installing Pidgin
 
* Quit Carrier
 
* Delete your ~/.purple directory '''(Warning: this will remove all your user settings for any programs that use libpurple, i.e. Pidgin, Carrier, etc.)'''
 
<pre>
 
rm -r ~/.purple
 
</pre>
 
* Remove Carrier and libpurple
 
<pre>
 
pacman -R carrier libpurple
 
</pre>
 
* Install Pidgin and libpurple
 
<pre>
 
pacman -S pidgin libpurple
 
</pre>
 
 
 
== History Import Kopete To Pidgin ==
 
* Install xalan-c
 
<pre>
 
pacman -S xalan-c
 
</pre>
 
* Create ~/bin/history_import_kopete2pidgin.sh with this code:
 
<pre>
 
 
#!/bin/sh
 
#!/bin/sh
  
Line 225: Line 184:
 
CURRENT_DIR=~/bin
 
CURRENT_DIR=~/bin
  
cd ~
+
cd
  
 
if [ ! -d $KOPETE_DIR ];then
 
if [ ! -d $KOPETE_DIR ];then
echo "Kopete log directory not found"
+
    echo "Kopete log directory not found"
exit 1;
+
    exit 1;
 
fi
 
fi
  
 
if [ ! -d $PIDGIN_DIR ];then
 
if [ ! -d $PIDGIN_DIR ];then
echo "Pidgin log directory not found"
+
    echo "Pidgin log directory not found"
exit 2;
+
    exit 2;
 
fi
 
fi
  
for KOPETE_PROTODIR in `ls $KOPETE_DIR`
+
for KOPETE_PROTODIR in $(ls $KOPETE_DIR); do
do
+
    PIDGIN_PROTODIR=$(echo $KOPETE_PROTODIR | sed 's/Protocol//' | tr [:upper:] [:lower:])
PIDGIN_PROTODIR=`echo $KOPETE_PROTODIR | sed 's/Protocol//' | tr [:upper:] [:lower:]`
+
    for accnum in $(ls $KOPETE_DIR/$KOPETE_PROTODIR); do
for accnum in `ls $KOPETE_DIR/$KOPETE_PROTODIR`
+
        echo "Account number: $accnum"
do
+
        for num in $(ls $KOPETE_DIR/$KOPETE_PROTODIR/$accnum); do
echo "Account number: $accnum"
+
            FILENAME=$(Xalan $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin_filename.xslt)
for num in `ls $KOPETE_DIR/$KOPETE_PROTODIR/$accnum`
+
            if [ $? = 0 ]; then
do
+
                echo "$KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num"
FILENAME=`Xalan $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin_filename.xslt`
+
                echo " -> $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME"
if [ $? = 0 ]; then
+
                mkdir -p $(dirname $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME)
echo "$KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num"
+
                Xalan -o $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin.xslt
echo " -> $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME"
+
            fi
mkdir -p `dirname $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME`
+
        done
Xalan -o $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin.xslt
+
    done
fi
 
done
 
done
 
 
done
 
done
</pre>
+
</nowiki>}}
* Make ~/bin/history_import_kopete2pidgin.sh executable
+
* Make {{ic|~/bin/history_import_kopete2pidgin.sh}} executable:
<pre>
+
chmod +x ~/bin/history_import_kopete2pidgin.sh
chmod +x ~/bin/history_import_kopete2pidgin.sh
+
* Create {{ic|~/bin/history_import_kopete2pidgin.xslt}} with this code:
</pre>
+
{{bc|1=
* Create ~/bin/history_import_kopete2pidgin.xslt with this code:
 
<pre>
 
 
<?xml version="1.0"?>
 
<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
<nowiki><xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"></nowiki>
<xsl:output method="text" indent="no" />
+
    <xsl:output method="text" indent="no" />
  
<xsl:template match="kopete-history">
+
    <xsl:template match="kopete-history">
<xsl:apply-templates select="msg"/>
+
        <xsl:apply-templates select="msg"/>
</xsl:template>
+
    </xsl:template>
  
<xsl:template match="msg">
+
    <xsl:template match="msg">
<xsl:text>(</xsl:text>
+
        <xsl:text>(</xsl:text>
<xsl:value-of select="translate(substring-after(@time,' '),':',',')"/>
+
        <xsl:value-of select="translate(substring-after(@time,' '),':',',')"/>
<xsl:text>) </xsl:text>
+
        <xsl:text>) </xsl:text>
<xsl:value-of select="@nick"/>
+
        <xsl:value-of select="@nick"/>
<xsl:if test="not(@nick) or @nick = ''">
+
        <xsl:if test="not(@nick) or @nick = ''">
<xsl:value-of select="@from"/>
+
            <xsl:value-of select="@from"/>
</xsl:if>
+
        </xsl:if>
<xsl:text>: </xsl:text>
+
        <xsl:text>: </xsl:text>
<xsl:value-of select="."/>
+
        <xsl:value-of select="."/>
 
<xsl:text>
 
<xsl:text>
 
</xsl:text>
 
</xsl:text>
</xsl:template>
+
    </xsl:template>
 
</xsl:stylesheet>
 
</xsl:stylesheet>
</pre>
+
</nowiki>}}
* Create ~/bin/history_import_kopete2pidgin_filename.xslt with this code:
+
* Create {{ic|~/bin/history_import_kopete2pidgin_filename.xslt}} with this code:
<pre>
+
{{bc|1=
 
<?xml version="1.0"?>
 
<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
<nowiki><xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"></nowiki>
<xsl:output method="text" indent="no" />
+
    <xsl:output method="text" indent="no" />
  
<xsl:template match="kopete-history">
+
    <xsl:template match="kopete-history">
<xsl:value-of select="head/contact[@type = 'myself']/@contactId"/>
+
        <xsl:value-of select="head/contact[@type = 'myself']/@contactId"/>
<xsl:text>/</xsl:text>
+
        <xsl:text>/</xsl:text>
<xsl:value-of select="head/contact[not(@type)]/@contactId"/>
+
        <xsl:value-of select="head/contact[not(@type)]/@contactId"/>
<xsl:text>/</xsl:text>
+
        <xsl:text>/</xsl:text>
<xsl:value-of select="head/date/@year"/>
+
        <xsl:value-of select="head/date/@year"/>
<xsl:text>-</xsl:text>
+
        <xsl:text>-</xsl:text>
<xsl:if test="head/date/@month &lt; 10">0</xsl:if>
+
        <xsl:if test="head/date/@month &amp;lt; 10">0</xsl:if>
<xsl:value-of select="head/date/@month"/>
+
        <xsl:value-of select="head/date/@month"/>
<xsl:text>-</xsl:text>
+
        <xsl:text>-</xsl:text>
<xsl:if test="string-length(substring-before(msg[1]/@time,' ')) &lt; 2">0</xsl:if>
+
        <xsl:if test="string-length(substring-before(msg[1]/@time,' ')) &amp;lt; 2">0</xsl:if>
<xsl:value-of select="translate(msg[1]/@time,' :','.')"/>
+
        <xsl:value-of select="translate(msg[1]/@time,' :','.')"/>
<xsl:text>+0200EET.txt</xsl:text>
+
        <xsl:text>+0200EET.txt</xsl:text>
</xsl:template>
+
    </xsl:template>
 
</xsl:stylesheet>
 
</xsl:stylesheet>
</pre>
+
}}
* Execute the command in the shell
+
* Execute the command in the shell:
<pre>
+
 
~/bin/history_import_kopete2pidgin.sh
+
~/bin/history_import_kopete2pidgin.sh
</pre>
+
 
 +
== Backup ==
 +
 
 +
Save {{ic|~/.purple}} to backup all message logs, accounts and other application data.
 +
 
 +
== Troubleshooting ==
 +
 
 +
 
 +
=== Version Match for Sametime ===
 +
 
 +
There was an issue if you would connect to the Sametime via Pidgin, it prompt "Version Match". A potential solution on the client side is to fake the version in accounts.xml. Insert/change the lines:
 +
 
 +
<setting name='fake_client_id' type='bool'>1</setting>
 +
<setting name='client_minor' type='int'>8511</setting>
 +
 
 +
in the <settings> section of Sametime account in accounts.xml which is located in $HOME/.purple/ folder.
 +
 
 +
=== Browser error ===
 +
 
 +
If clicking a link within Pidgin creates an error message about trying to use 'sensible-browser' to open a link, try editing {{ic|~/.purple/prefs.xml}}. Find the line referencing 'sensible-browser' and change it to this:
 +
<pref name='command' type='path' value='firefox'/>
 +
 
 +
This example assumes you use [[Firefox]].
 +
 
 +
As an alternative if the method above does not work you can set the desired browser in the pidgin preferences in the section "Browser".
 +
 
 +
=== ICQ Buddy Information encoding fix ===
 +
 
 +
You can change encoding for ICQ account if encoding in Buddy Information is not correct:
 +
Account > ''your ICQ account'' > Edit account > Advanced tab
 +
Select {{ic|Encoding: CP1251}} (for Cyrillic).
  
==See also==
+
== See also ==
* [http://pidgin.im Pidgin homepage]
+
* [https://developer.pidgin.im/wiki/Using%20Pidgin Using Pidgin]
* [http://lukav.com/wordpress/2008/03/30/history-import-kopete-to-pidgin History Import Kopete To Pidgin]
+
* [[Wikipedia:Pidgin_(software)]]
 +
* [http://lukav.com/wordpress/2008/03/30/history-import-kopete-to-pidgin History import Kopete to Pidgin]
 +
* [https://confluence.atlassian.com/hipchatkb/connecting-to-hipchat-using-pidgin-751436267.html Connecting to HipChat using Pidgin]
 +
*{{pkg|finch}}, a console based libpurple client, essentially Pidgin in a terminal

Latest revision as of 16:22, 17 October 2019

Pidgin is an easy to use and free chat client used by millions. Connect to Google Talk, ICQ, IRC, XMPP, and more chat networks all at once.

Installation

Install the pidgin package. Notable variants are:

  • Pidgin Light — Light Pidgin version without GStreamer, Tcl/Tk, XScreenSaver, video/voice support.
http://pidgin.im/ || pidgin-lightAUR

You may also want to install additional plugins from the purple-plugin-pack.

Spellcheck

The aspell package will be installed as a dependency, but to prevent all of your text from showing up as incorrect you will need to install an aspell dictionary. See the aspell article.

Note: The switch spell plugin is included in the purple-plugin-pack. It allows you to switch between multiple languages.

Services

AIM

Pidgin has out-of-the-box support for AOL Instant Messenger (AIM). Although AIM has officially ceased, unofficial AIM-based servers like AIM Phoenix operate and can be used on Pidgin by changing the server address in the AIM protocol account settings.

Discord plugin

Install the purple-discord-gitAUR package.

Then add a new account, select Discord as the protocol, enter your Discord login e-mail address and its password.

Facebook

Install the purple-facebook package. (or purple-facebook-gitAUR)

Then add a new account, select Facebook as the protocol, enter your Facebook username and password and login.


Google (Hangouts)

Install the purple-hangouts-hgAUR package.

ICQ

Pidgin has out-of-the-box support for ICQ. Since December 2018, the old OSCAR protocol is no longer officially supported as it has been replaced by the newer WIM protocol. Currently, Pidgin only comes with the original OSCAR ICQ protocol. To make use of the new WIM protocol on ICQ, you should install the purple-icyque-gitAUR plug-in.

IRC

This is a small tutorial for connecting to Freenode. It should work for other IRC networks as long as you substitute the port numbers and other specific settings.

Go to Accounts > Manage Accounts > Add. Fill/select the following options:

Protocol: IRC
Username: your username

Now go to Buddies > New instant message (or hit Ctrl+m), fill 'freenode.net' in the textbox and username@irc.freenode.net, then click 'Ok'. Type:

/join #archlinux

The channel is irrelevant.

In order to register your nick, type:

/msg nickserv register password email-addres

Follow the instructions from the registration mail. For further help type:

/msg nickserv help
/msg nickserv help command

This final step will add your channel to 'Buddies': go to Buddies > Add chat, fill the correct channel in the textbox named channel (#archlinux).

Sametime protocol

Install the libpurple-meanwhileAUR package. The 'Sametime' protocol will be available when creating an account.

SIP/Simple protocol for Skype for Business/Office 365/Lync

Install the pidgin-sipeAUR package.

Skype plugin

Install the purple-skypeweb or purple-skypeweb-gitAUR package.

Slack plugin

Install the slack-libpurple-gitAUR package.

Rocket.Chat plugin

Install the purple-rocketchatAUR[broken link: package not found] package.

Telegram plugin

Install the telegram-purpleAUR or telegram-purple-gitAUR package.

Enter your Telegram phone number when creating the account, after which you will receive an SMS text message with a confirmation code, which you'll have to enter to authorize your Telegram protocol account on Pidgin.

XMPP

Pidgin has out-of-the-box support for the XMPP/Jabber chat protocol. Some additional plugins exist on the AUR for support of XMPP extensions such as OMEMO (libpurple-lurchAUR) or Message Carbons (libpurple-carbonsAUR).

Security

Pidgin uses Libpurple 2 which stores passwords unencrypted (in plaintext) in $HOME/.purple/account.xml, see [1]. You can store them in a keyring by using a plugin like:

Privacy

Pidgin has some privacy rules set by default. Namely, the whole world cannot send you messages; only your contacts or people selected from a list. Adjust this, and other settings in Tools > Privacy.

Pidgin-OTR

This is a plugin that brings Off-The-Record (OTR) messaging to Pidgin. OTR is a cryptographic protocol that will encrypt your instant messages.

First you need to install pidgin-otr from the official repositories. Once this has been done, OTR has been added to Pidgin.

  1. To enable OTR, start Pidgin and go to Tools > Plugins or press Ctrl+u. Scroll down to the entry entitled "Off-The-Record Messaging". If the checkbox beside it is not checked, check it.
  2. Next, click on the plugin entry and select "Configure plugin" at the bottom. Select which account you wish to generate a key for, then click "Generate". You will have now generated a private key. If you are not sure what the other options do, leave them, the default options will work fine.
  3. The next step is to contact a buddy who also has OTR installed. In the chat window, a new icon should appear to the top right of your text input box. Click on it, and select "Start private conversation". This will start an 'Unverified' session. Unverified sessions are encrypted, but not verified - that is, you have started a private conversation with someone using your buddy's account who has OTR, but who might not be your buddy. The steps for verification of a buddy are beyond the scope of this section; however, they might be added in the future.

Pidgin-Encryption

pidgin-encryptionAUR transparently encrypts your instant messages with RSA encryption. Easy-to-use, but very secure.

You can enable it the same way as Pidgin-OTR.

Now you can open conversation window and new icon should appear beside menu. Press it to enable or disable encryption. Also if you want to make encryption enabled by default right-click on a buddy's name (in your buddy list), and select Turn Auto-Encrypt On. Now, whenever a new conversation window for that buddy is opened, encryption will start out as enabled.

Pidgin-GPG

Pidgin-GPG transparently encrypt conversations using GPG, and taking advantage of all the features of a pre-existing WoT.

The plugin is available on AUR as pidgin-gpg-gitAUR. It can be enabled the same way as the previously mentioned ones.

Other packages

Arch has other Pidgin-related packages. Here are the most popular (for a thorough list, search the AUR):

  • pidgin-libnotify - Libnotify support, for theme-consistent notifications
  • purple-libnotify-plusAUR - Notifications with Libnotify which does work with notify-osd. It might matter for WMs without DE, like i3, the original pidgin-libnotify instead uses plain messagebox there.
  • guifications[broken link: package not found] - Toaster-style popup notifications
  • pidgin-latexAUR - A small latex plugin for pidgin. Put math between $$ and have it rendered (recepient also needs to have this installed)

Auto logout on suspend

If you suspend your computer pidgin seems to stay connected for about 15 minutes. To prevent message loss, it is needed to set your status offline before suspending or hibernating. The status message won't be changed.

Therefore create a new systemd unit pidgin-suspend in /etc/systemd/system Take the following snippet and replace myuser with your user.

[Unit]
Description=Suspend Pidgin
Before=sleep.target
StopWhenUnneeded=yes

[Service]
Type=oneshot
User=myuser
RemainAfterExit=yes
Environment=DISPLAY=:0
ExecStart=-/usr/bin/purple-remote setstatus?status=offline
ExecStop=-/usr/bin/purple-remote setstatus?status=available

[Install]
WantedBy=sleep.target

Minimize to tray

To make use of the Xfce system tray go to preferences and enable the system tray in the section "Interface". You can now close the main window and run pidgin minimized. You will also be able to see message notifications in the tray.

History import Kopete to Pidgin

  • Install xalan-c and create ~/bin/history_import_kopete2pidgin.sh with this code:
#!/bin/sh

KOPETE_DIR=~/.kde4/share/apps/kopete/logs
PIDGIN_DIR=~/.purple/logs
CURRENT_DIR=~/bin

cd

if [ ! -d $KOPETE_DIR ];then
    echo "Kopete log directory not found"
    exit 1;
fi

if [ ! -d $PIDGIN_DIR ];then
    echo "Pidgin log directory not found"
    exit 2;
fi

for KOPETE_PROTODIR in $(ls $KOPETE_DIR); do
    PIDGIN_PROTODIR=$(echo $KOPETE_PROTODIR | sed 's/Protocol//' | tr [:upper:] [:lower:])
    for accnum in $(ls $KOPETE_DIR/$KOPETE_PROTODIR); do
        echo "Account number: $accnum"
        for num in $(ls $KOPETE_DIR/$KOPETE_PROTODIR/$accnum); do
            FILENAME=$(Xalan $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin_filename.xslt)
            if [ $? = 0 ]; then
                echo "$KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num"
                echo " -> $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME"
                mkdir -p $(dirname $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME)
                Xalan -o $PIDGIN_DIR/$PIDGIN_PROTODIR/$FILENAME $KOPETE_DIR/$KOPETE_PROTODIR/$accnum/$num $CURRENT_DIR/history_import_kopete2pidgin.xslt
            fi
        done
    done
done
  • Make ~/bin/history_import_kopete2pidgin.sh executable:
chmod +x ~/bin/history_import_kopete2pidgin.sh
  • Create ~/bin/history_import_kopete2pidgin.xslt with this code:
<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="text" indent="no" />

    <xsl:template match="kopete-history">
        <xsl:apply-templates select="msg"/>
    </xsl:template>

    <xsl:template match="msg">
        <xsl:text>(</xsl:text>
        <xsl:value-of select="translate(substring-after(@time,' '),':',',')"/>
        <xsl:text>) </xsl:text>
        <xsl:value-of select="@nick"/>
        <xsl:if test="not(@nick) or @nick = ">
            <xsl:value-of select="@from"/>
        </xsl:if>
        <xsl:text>: </xsl:text>
        <xsl:value-of select="."/>
		<xsl:text>
</xsl:text>
    </xsl:template>
</xsl:stylesheet>
</nowiki>
  • Create ~/bin/history_import_kopete2pidgin_filename.xslt with this code:
<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="text" indent="no" />

    <xsl:template match="kopete-history">
        <xsl:value-of select="head/contact[@type = 'myself']/@contactId"/>
        <xsl:text>/</xsl:text>
        <xsl:value-of select="head/contact[not(@type)]/@contactId"/>
        <xsl:text>/</xsl:text>
        <xsl:value-of select="head/date/@year"/>
        <xsl:text>-</xsl:text>
        <xsl:if test="head/date/@month &lt; 10">0</xsl:if>
        <xsl:value-of select="head/date/@month"/>
        <xsl:text>-</xsl:text>
        <xsl:if test="string-length(substring-before(msg[1]/@time,' ')) &lt; 2">0</xsl:if>
        <xsl:value-of select="translate(msg[1]/@time,' :','.')"/>
        <xsl:text>+0200EET.txt</xsl:text>
    </xsl:template>
</xsl:stylesheet>
  • Execute the command in the shell:
~/bin/history_import_kopete2pidgin.sh

Backup

Save ~/.purple to backup all message logs, accounts and other application data.

Troubleshooting

Version Match for Sametime

There was an issue if you would connect to the Sametime via Pidgin, it prompt "Version Match". A potential solution on the client side is to fake the version in accounts.xml. Insert/change the lines:

<setting name='fake_client_id' type='bool'>1</setting>
<setting name='client_minor' type='int'>8511</setting>

in the <settings> section of Sametime account in accounts.xml which is located in $HOME/.purple/ folder.

Browser error

If clicking a link within Pidgin creates an error message about trying to use 'sensible-browser' to open a link, try editing ~/.purple/prefs.xml. Find the line referencing 'sensible-browser' and change it to this:

<pref name='command' type='path' value='firefox'/>

This example assumes you use Firefox.

As an alternative if the method above does not work you can set the desired browser in the pidgin preferences in the section "Browser".

ICQ Buddy Information encoding fix

You can change encoding for ICQ account if encoding in Buddy Information is not correct:

Account > your ICQ account > Edit account > Advanced tab

Select Encoding: CP1251 (for Cyrillic).

See also