= Plugins =

[[TOC(inline, noheading)]]

== Official Plugins == 

Pidgin and Finch ship with a large collection of officially supported plugins which modify standard behavior in a number of ways.  You can manage available plugins by accessing the "Tools" menu from the Buddy List window and selecting "Plugins."

If you have a problem with one of the plugins included with the software, you should report it via a [/simpleticket ticket].  Generally our stock plugins will have the same version number as Pidgin or Finch and the web site address for the plugin will be listed as http://pidgin.im/

== Third-Party Plugins ==

Third party plugins '''are not supported'''.  Do not open tickets on our trac about these plugins.  If you do, those tickets will be closed as invalid.

If you are listing a plugin on this page, note that we ''will'' de-list the plugin if source code is not provided.  Because Pidgin and libpurple are licensed under the GPLv2, the way plugins are loaded within Pidgin and libpurple require that the plugins be licensed in a GPL-compatible manner, which generally includes providing source code.  We will also remove entries from this page that contain broken links, and we will remove any entry with links pointing to malicious sites or software.  Also, the column in the tables that says '''Short Description''' is intended to be '''''short'''''.  Keep the descriptions as short as possible.  Also, do not use profanity or pornographic terminology in your descriptions or plugin names.  We will edit descriptions or de-list plugins that include such terminology or have overly long descriptions.
[[BR]]
[[BR]]
=== Additional Protocols ===

There are third-party plugins for some protocols:

|| '''Protocol Name''' || '''Website''' || '''Short Description''' ||
|| Facebook IM || [http://code.google.com/p/pidgin-facebookchat/ Go] || Facebook social network || 
|| Gammu || [http://code.google.com/p/purple-gammu/ Go] || Protocol to send SMS through your phone via usb/serial/bluetooth/irda ||
|| Mail.ru Agent (Mrim-prpl) || [http://fireforge.net/mediawiki/index.php/Mrim-prpl Go] || Russian network ||
|| Mail.ru Agent (pidgin-mra) || [http://github.com/dreadatour/pidgin-mra Go] || Russian network ||
|| Microblog || [http://microblog-purple.googlecode.com Go] || Twitter/Identica/Laconica updates ||
|| msn-pecan || [http://code.google.com/p/msn-pecan/ Go] || Alternative MSN access ||
|| MXit || [http://devzone.mxit.com/libPurple/ Go] || MXit IM ||
|| !NateOn || [http://nateon.haz3.com/forum/ Go] || Korean network [NateOn More info] ||
|| !NetNexus || [http://netnexus-pidgin.googlecode.com/ Go] || netnexus.com's chatrooms ||
|| Netsoul || [http://sourceforge.net/projects/gaim-netsoul/ Go] || French network ||
|| Ning || [http://pidgin-ning.googlecode.com/ Go] || Ning-based social networks ||
|| !OkCupid || [http://okcupid-pidgin.googlecode.com/ Go] || !OkCupid.com dating website ||
|| Omegle || [http://pidgin-omegle.googlecode.com/ Go] || omegle.com's web-based random chat ||
|| Rediffbol || [http://rediffbol-prpl.sourceforge.net/ Go] || Indian network ||
|| Skype IM || [http://code.google.com/p/skype4pidgin/ Go] ||  ||
|| SIPE || [http://sipe.sourceforge.net/ Go] || Microsoft Office Communicator, Reuters Messaging ||
|| Tlen.pl || [http://nic.com.pl/~alek/pidgin-tlen/ Go] || Polish network ||
|| Twitter Protocol || [http://code.google.com/p/libpurple-twitter-protocol/ Go] || Twitter Buddylist Protocol ||
|| WinMX Peer Network || [http://sourceforge.net/projects/wpn-gaim-prpl/ Go] || File sharing network ||
|| Xfire || [http://gfire.sf.net/ Go] || Gaming network ||
[wiki:"Protocol Specific Questions#OtherProtocols" Why are some protocols not supported?]
[[BR]]
=== Security and Privacy ===
|| '''Plugin Name''' || '''Website''' || '''Short Description''' ||
|| bOt_tOOls || [http://eric.dziewa.com/?p=522 Go] || Configurable plugin for auto-ignoring yahoo spammers ||
|| Bot Sentry || [http://sourceforge.net/projects/pidgin-bs/ Go] || Stop spam bots ||
|| Off-the-Record Messaging || [http://www.cypherpunks.ca/otr/ Go] || Encrypts conversations and provides security even when keys are compromised ||
|| Pidgin-Encryption || [http://pidgin-encrypt.sf.net/ Go] || Encrypts conversations using stored RSA keys ||
|| Pidgin-Paranoia || [http://pidgin-paranoia.sourceforge.net/ Go] || Encrypts conversations using one-time pads ||
|| Pidgin-privacy-please || [http://freshmeat.net/projects/pidgin-pp/ Go] || Stop spam bots ||

[[BR]]
=== Notifications ===
|| '''Plugin Name''' || '''Website''' || '''Short Description''' ||
|| AlienFX-notification || [http://3d.benjamin-thaut.de/?p=11 Go] || Provides notification over the AlienFX device of Alienware laptops and PCs ||
|| Audible Alerts || [https://sourceforge.net/projects/audiblealerts/ Go] || Audible notification of a received IM by reading the buddy's screen name ||
|| Command-notification || [http://guysoft.wordpress.com/pidgin-x-chat-plugin-new-message/ Go] || Based off Led-notification this plugin will execute a command on receiving a new message||
|| Guifications || [http://plugins.guifications.org/trac/wiki/Guifications Go] || Provides "toaster" popup notifications. ||
|| KNotifications || [http://code.google.com/p/pidgin-knotifications/ Go] || Perl plugin that provides KDE 4 notifications ||
|| Led-notification || [http://simo.h.mattila.googlepages.com/led-notification Go] || Provides notifications with laptops' extra LEDs and similar ||
|| led-notification || [http://github.com/Sitwon/led-notification Go] || Fork of the above. Adds support for !ThinkPads. ||
|| Mumbles-project Plugin || [http://www.mumbles-project.org/2007/06/03/pidgin-plugin-now-available/ Go] || Pidgin Plugin for mumbles-project - modern notification system for Gnome (Linux only). ||
|| MX610-notification || [http://simo.h.mattila.googlepages.com/mx610-notification Go] || Provides notifications with Logitech MX610's IM led ||
|| Notifo Notifications || [http://code.google.com/p/gtk-ftischhauser-notifo/ Go] || Pushes IMs to your iPhone when you're away using the free Notifo service ||
|| pidgin-capsnot || [http://code.google.com/p/pidgin-capsnot/ Go] || Keyboard LED Notification (caps-lock/num-lock/scroll-lock) for Pidgin/Finch ||
|| Pidgin-dock || [http://code.google.com/p/pidgin-cairo-dock/ Go] || Emulate Mac OS X - dock behaviour with cairo-dock, support [http://www.adiumxtras.com/ Adium themes]||
|| Pidgin-Libnotify+ || [http://sardemff7.github.com/ Go] || Provides libnotify notifications ||
|| Pidgin Advanced Sound Notification || [https://sourceforge.net/projects/pidgin-sound/ Go] || This plugin adds sounds for some notifications to pidgin (e.g. "Incoming Filetransfer" or "Authentication requested"). ||
|| PidginSnarl || [http://tlhan-ghun.de/Projects/PidginSnarl/ Go] || Notifications using Snarl on Windows ||
|| Smart Ear || [http://somewhere.fscked.org/proj/smartear/ Go] || Customized per-buddy sound events ||
[[BR]]
=== Profile and status updates ===
|| '''Plugin Name''' || '''Website''' || '''Short Description''' ||
|| Away-on-Lock || [http://costela.net/projects/awayonlock Go] || Sets you as away when the screensaver gets activated. (Linux Gnome and KDE4) ||
|| Full Screen Busy || [http://lostrealm.com/pidgin/fsb/ Go] || Sets the status to busy (or any saved status) when a full screen application is detected. (Windows) ||
|| Google Shared Status || [http://www.siorarina.net/gss/index.html Go] || Adds Google Shared Status compatibility that permit to set the status for all the resources connected. This allows to go Invisible... ||
|| Google Talk Invisible || [http://fahhem.com/pidgin/ Go] || Adds the ability to go invisible with Google Talk  (XMPP/Jabber protocol) ||
|| Jabber Pseudo Invisibility || [http://www.siorarina.net/jpi/index.html Go] || Adds a pseudo invisible status for Jabber/XMPP accounts namely you result offline but you can monitor the status of your favourite buddies (and start conversations). Read carefully How to Use!!! ||
|| Last.FM Plugin || [http://pidgin-lastfm.naturalnet.de Go] || Shows information from your Last.FM / Audioscrobbler profile in your status message. ||
|| Lock 'n' Roll || [http://csammisrun.net/blog/2009/06/lock-n-roll-11/ Go] || Set any active accounts to Away (with a user-defined message if applicable) when the workstation locks, and back to Available when it is unlocked. If an account has an existing away message set, Lock ‘n’ Roll leaves it alone. (Windows)||
|| Pidgin-Countdown || [https://launchpad.net/pidgin-countdown Go] || Sets your status counting down to a specific date & time. ||
|| Pidgin-Identica-Status || [http://code.google.com/p/pidgin-identica-status/ Go] || Use a feed from identi.ca as your Pidgin status. ||
|| Status Hot Keys || [http://www.castledragmire.com/Projects/Status_Hot_Keys Go] || Global shortcut keys to set status and manipulate the buddy window visibility ||
|| Status RSS || [http://www.len.ro/2010/07/status-rss-plugin-for-pidgin/ Go] || Update status from RSS feed ||
|| Status to Twitter || [http://code.google.com/p/pidgin-status-to-twitter/ Go] || Update Twitter with your Pidgin Status ||
|| Twitter in your Profile || [http://code.google.com/p/pidgin-twitter-profile/ Go] || Insert your Twitter history into your profile. It gets updated periodically. ||
|| xssidle || [http://github.com/mehturt/pidgin Go] || Set idle time based on information from X11 Screen Saver (such as xscreensaver). ||
==== 'now playing' plugins ====
|| '''Plugin Name''' || '''Website''' || '''Short Description''' ||
|| !MusicInfo || [http://www.pidginmusic.info/ Go] || Displays the currently-playing music in your status message and profile. Winamp API compatible. ||
|| Music Tracker || [http://code.google.com/p/pidgin-musictracker/ Go] || Displays the music track currently playing in the status message. Supports a wide range of audio players. ||
|| Pidgin-Audacious-Remote || [http://pidginaudacious.sourceforge.net/ Go] || Updates the status message using custom information retrieved from Audacious Media Player. This plugin also allows control over Audacious Media Player from the Pidgin conversation windows (play, pause, next...). || 
|| pilt spotify || [http://github.com/pilt/spotify Go] || "now listening" plugin for spotify ||
|| YuLastFM || [https://sourceforge.net/projects/yulastfm/ Go] || Yu Last.fm Pidgin tune status plugin. ||
[[BR]]
=== Interface tweaks ===
|| '''Plugin Name''' || '''Website''' ||'''Short Description'''||
|| Adium to Pidgin themes converter || [http://code.google.com/p/adium2pidgin-themes/ Go] || Allows to convert themes from [http://www.adiumxtras.com/ Adiumxtras site]||
|| Autohide || [http://pidgin.dotninesoft.de/ Go] || Buddy list improvements like autohide, always on top and hide min/max buttons||
|| autoresize || [http://raoulito.info/plugins/pidgin_autoresize/ Go] || Automatically update the buddy list to fit its contents (vertically). ||
|| Character Counter || [http://dossy.org/archives/000545.html Go] || Plugin for displaying the character count of the current message. ||
|| Extended Buddy List Sort || [http://freakazoid.teamblind.de/2008/12/13/pidgin-extended-buddy-list-sort-plugin/ Go] || Adds more buddy list sorting options ||
|| keys per minute || [http://3d.benjamin-thaut.de/?p=12 Go] || Counts the keys per minute while you are typing a message and displays it. ||
|| Manual Resize || [ticket:5296 Go] and [http://www.freshports.org/net-im/pidgin-manualsize/ Go] || Allows manually resizing the conversation window entry area. ||
|| pidgin-cmds || [http://code.google.com/p/pidgin-cmds/ Go] || Various conversation commands ||
|| Pidgin Conversation Locker || [http://code.google.com/p/pidgin-conversation-locker/ Go] || Prevent closing of important conversations(/tabs) by selectively locking them. ||
|| pidgin-nudge || [http://code.google.com/p/pidgin-nudge/ Go] || Shakes your conversation window when you receive a nudge/buzz/zap ||
|| Pidgin Personal Bar || [http://code.google.com/p/pidgin-personalbar/ Go] || Adds a section at the top of your buddy list to change your display name and personal message. ||
|| Pidgin Windows Position Manager || [http://extpos.mdsc.info/ Go] || Places new conversation windows intelligently in Windows (i.e. doesn't always put them in the top left corner). ||
|| Protocol Icon Override || [http://code.google.com/p/pidgin-icon-override/ Go] || Lets you pick the protocol icon to display per-account ||
|| Quote selected text || [http://launchpad.net/quote/ Go] || Quick specify message to answer ||
|| Scroll to bottom || [http://pidgin.dotninesoft.de/ Go] || Scrolls chat history of created conversation windows automatically to the bottom. ||
|| Session Save || [http://somewhere.fscked.org/proj/sessionsave/ Go] || Session Save will remember what conversation windows you had open the last time you used Pidgin, and re-open them for you when you sign on. ||
|| Smiley Shortcuts || [https://sourceforge.net/project/platformdownload.php?group_id=186081 Go] || Inserts a smiley on ctrl+(number) combination.  ||
|| !TooBars || [http://vayurik.ru/wordpress/toobars/ Go] || Add toolbar, status bar, context menu to Pidgin buddy list, hide main menu, change all status by menu (not through Statusbox!) and much more||
|| !TooButtons || [http://vayurik.ru/wordpress/toobuttons/ Go] || Add Send and Close buttons to Pidgin conversations||
|| Toolbar Shrink || [http://freakazoid.teamblind.de/2010/06/10/pidgin-toolbar-shrink/ Go] || Shrinks the toolbar of the conversation windows by hiding the text of the buttons.||
|| !WrapMenu || [http://vayurik.ru/wordpress/wrapmenu/ Go] || Wrap main menu if it is too wide||
[[BR]]
=== Accounts and logs ===
|| '''Plugin Name''' || '''Website''' || '''Short Description''' ||
|| IM-History Plugin || [http://www.im-history.com/ Go] || Provides easy and convenient way to store your chats and contact list online (using im-history.com service). ||
|| logstatus || [http://bla.thera.be/archives/20 Go] || Logs all the status changes to the buddy history. ||
|| Office Hours || [http://www.orenet.co.uk/opensource/pidgin-oo/ Go] || A plugin that logs you out if you go idle outside your 'office hours' so you can log in the same account(s) at home. In perl so may not work on MS Windows ||
|| pidgin-autoanswer || [http://sourceforge.net/projects/pidgin-autoansw Go] || A personal adviser, that tries to find suitable answers in your previous logs ||
|| pidgin-juice || [http://pidgin-juice.googlecode.com/ Go] || Web-based iPhone interface for Pidgin/Finch ||
|| Pidgin Backup || [comment:ticket:3581:7 Go] || Simply back up your preferences (prefs.xml) ||
|| Web Pidgin || [http://www.thirdmartini.com/index.php/WebPidgin Go] || Access buddy list and conversations via mobile web browsers ||
|| Web Pidgin Z || [http://www.shaorang.com/webpidginz/ Go] || Fork from the original Web Pidgin. A lot of new features and bugfixes like Ajax support, digest authentication, webserver logs and gtalk-like grouping of messages and much more ||
[[BR]]
=== Miscellaneous ===
|| '''Plugin Name''' || '''Website''' ||'''Short Description'''||
|| b64 || [http://chetanv.googlepages.com/technicalstuff Go] || Base 64 encoding of chat messages (A very simple Perl plugin) ||
|| Birthday Reminder || [http://freakazoid.teamblind.de/2009/02/14/pidgin-birthday-reminder/ Go] || Reminds you of your buddies birthdays. ||
|| Block <user> has left the conversation. || [http://github.com/oakmac/Pidgin-Plugin-block-user-has-left-the-conversation/ Go] || Very simple plugin that blocks the message "<user> has left the conversation." ||
|| Block AOL System Msg || [http://github.com/oakmac/Pidgin-Plugin--Block-AOL-System-Msg/ Go] || Very simple plugin that blocks messages from "AOL System Msg" when you are logged into AIM from multiple locations. ||
|| core-answerscripts || [http://github.com/Harvie/libpurple-core-answerscripts Go] || Framework for hooking simple but powerful "answerscripts" to received messages. ||
|| !DockApp || [http://emvi.eu.org/pidgin_dockapp/index_en.html Go] or [http://wamarek.republika.pl/pidgin_dockapp/index_en.html Go] || Allows Pidgin to appear as an !AfterStep Wharf icon. ||
|| Extended Preferences || [http://gaim-extprefs.sf.net/ Go] || Provides some often-requested preferences ||
|| Fonomo Video || [http://www.fonomo.com/software/pidgin.html Go ] || Enables Video-chat invitations via Fonomo.com (requires Adobe Flash v9 or higher) ||
|| Google Invisibility Half Scan || [http://www.siorarina.net/gihs/index.html Go ] || Find out if your (Gtalk) buddies are INVISIBLE. Note: This is an "HALF SCAN" because you can not establish with certainty that a buddy is invisible (read Description).||
|| Google Invisibility Tracker || [http://www.siorarina.net/git/index.html Go ] || This plugin alerts you when a buddy of yours (using Gmail, GTalk Lab Edition or iGoogle) go invisible ||
|| Hide Inactive Buddies || [http://code.google.com/p/pidgin-plugins Go] || Plugin to hide inactive buddies in buddy list. Determine inactive buddy by status. ||
|| Juick Plugin || [http://github.com/mad/pidgin-juick-plugin/tree/master Go] || Plugin specially designed for [http://juick.com Juick] xmpp-microblogging service, providing support for moods and inline avatars ||
|| Language Translator || [http://code.google.com/p/pidgin-plugins Go] || Plugin to translate outgoing text from English language to selected language. ||
|| Olark || [http://www.olark.com Go] || Live chat for your website, monitor website visitors (IP address, geo loc., URL visiting) from pidgin buddy list. ||
|| !PaintBoard || [http://code.google.com/p/pidgin-paintboard/ Go] || This plugin  allows you to draw with your friend on common board.||
|| pidginTeX || [http://pidgintex.googlecode.com/ Go] || Renders mathematical expressions. Lots of options, size, colors, etc. Built upon Pidgin-LaTeX.
|| Pidgin-convreverse || [https://sourceforge.net/projects/convreverse/ Go] || Reverses any word on all conversation. ||
|| Pidgin-googledesktop || [http://code.google.com/p/pidgin-googledesktop/ Go] || Google Desktop Indexing Plugin for Pidgin ||
|| Pidgin-LaTeX || [http://sourceforge.net/projects/pidgin-latex/ Go] || Allows you to include mathematical formulas in your conversations.  ||
|| Pidgin Embedded Video || [http://code.google.com/p/pidgin-embeddedvideo/ Go] || A GTK plugin to watch videos directly into your Pidgin conversation ||
|| Pidgin ZNC Helper || [https://sourceforge.net/projects/purpleznchelper/ Go] || This plugin removes ugly double-timestamps when replaying messages from ZNC bouncers, e.g. "(13:00:00) [12:00:00] Lunch time!". ||
|| Pidglet || [http://www.rudism.com Go] || A Windows Vista Sidebar Gadget that displays your buddy list. ||
|| Purple Plugin Pack || [http://plugins.guifications.org/trac/wiki/PluginPack Go] || Provides over 50 various plugins, including oft-requested IRC-related plugins. ||
|| QIP decoder || [http://www.sedaha.cz/qip-decoder/ Go] || Corrects invalid incoming QIP 2005 diacritics and local symbols ||
|| Send Screenshot || [http://code.google.com/p/pidgin-sendscreenshot/ Go] || Take a screenshot and send it to a buddy. ||
|| STFW || [http://linuxandwhatever.wordpress.com/stfw-pidgin-plugin/ Go] || A plugin that helps you teach your buddies how to use google. ||
|| Textbon || [http://textbon.com Go] || Textbon hyperlinks recognizable IM shorthands or acronyms or shortcuts.  On user click, these links translate Instant Messaging acronyms or shorthands to definitions using the [http://textbon.com] acronym database. ||
|| URL Shortener v0.9b3 || [http://otherware.org/downloads/pidgin_shorten.pl Go] || Perl plugin to shorten long urls. Especially useful for finch. Download and put in plugins directory. URLs are shortened as they come in if they exceed maximum length setting. no action required. Requires some perl libraries to work. ||
[[BR]]
== Development of Third-Party Plugins ==
If you're looking to develop a third-party plugin, you may find these resources valuable:
 * [wiki:CHowTo C Plugin Howto] (still in progress)
 * [/doxygen/ API Documentation]
 * [/doxygen/dev/html/plugin-i18n.html Third Party Plugin Translation Support]