pidgin is a graphical modular messaging client based on libpurple which is capable of connecting to AIM, MSN, Yahoo!, XMPP, ICQ, IRC, SILC, Novell GroupWise, Lotus Sametime, Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in other clients, as well as many unique features. Finch is not endorsed by or affiliated with America Online, ICQ, Microsoft, or Yahoo.
The Buddy List window contains a list of your buddies who are online and have allowed you to be notified of their presence. The icon to the left of each buddy indicates the buddy's current state and the protocol they are using. Double clicking a buddy will open a new Conversation window. Right clicking will pop up a menu:
For example, if a buddy's name screen name was jsmith1281xx and his real name was 'John Q. Smith,' one could create an alias as to identify the buddy by his common name.
The remainder of the menu will consist of protocol specific commands. These commands vary depending on the protocol.
At the bottom of the Buddy List are several buttons (if enabled in Preferences):
If Remember Password is chosen, the password will be saved in Pidgin's configuration file.
If Auto-Login is chosen, this account will automatically login upon starting Pidgin.
Each protocol has it's own specific options that can be found in the modify screen.
All options take effect immediately.
Display remote nicknames if no alias is set: Toggles whether server nickname data should be used if no local alias exists.
Show buttons as: Toggles between picture-only, text-only, picture and text or no buttons view of the buttons on the Buddy List.
Raise window on events: Tells Pidgin to bring the Buddy List window to the top when buddies sign in or out.
Show numbers in groups: The number of buddies from each group currently logged in will be shown along with the total number of buddies in the group.
Show buddy icons: Toggles the display of buddies' custom icons.
Show warning levels: Each buddy's warning level will be displayed next to the screen name. As a buddy's warning level increases, outgoing messages are more and more severely rate-limited.
Show idle times: The amount of time each buddy has been idle will be displayed next to the screen name (if the buddy has opted to have their client report this information).
Dim idle buddies: If enabled, idle buddies will be displayed in grey text instead of black text.
Automatically expand contacts: If enabled, contacts will automatically expand to show the associated buddies when the mouse is held over the contact for a short period.
Show buttons as...: The selected item will determine whether picture-only, text-only, combined picture/text, or no buttons will be used for Conversation windows.
Show formatting toolbar: Display the formatting toolbar between the upper and lower text boxes in conversations.
Show aliases in tabs/titles: Displays buddy alias instead of screen name in window tabs and titles.
Show buddy icons: For protocols that support it, buddy icons allow buddies to send small pictures to be displayed during the course of a conversation. Turning this option off hides those pictures.
Enable buddy icon animation: If these pictures happen to be animated, this option will enable the animation, otherwise only the first frame will be displayed.
Notify buddies that you are typing to them: Some protocols allow clients to tell their buddies when they are typing. This option enables this feature for protocols that supports it.
Raise IM windows on events: If enabled, IM Conversation windows will be brought to the top when new messages are received.
Raise Chat windows on events: If enabled, chat Conversation windows will be brought to the top when new messages are received.
Use multi-colored screen names in chats: Color code the screen names of users in chat rooms.
Show close buttons on tabs: Adds a close button to each tab.
Tab Placement...: Specifies where tabs are shown in the conversation window.
New conversation placement...: Determines where new conversations will be placed (Last created window / New window / windows grouped by group or account / separate windows for IMs and Chats).
Highlight misspelled words: Toggles highlighting of misspelled words as you type.
Ignore colors/font faces/font sizes: Tells Pidgin to disregard buddies' color/font/size information in displaying IMs or Chats.
Default Formatting: Allows specifying the default formatting to apply to all outgoing messages (only applicable to protocols that support formatting in messages).
Sounds while away: Determines whether sounds are played when an away message is up.
Sound Method lets the user choose between different playback methods. The user can also manually enter a command to be executed when a sound is to be played (%s expands to the full path to the file name).
Public IP: What IP address to use for file transfer and Direct IMs. This is mainly useful for users with multiple network interfaces or behind NAT.
Allows the user to select Pidgin's default web browser. Firefox, Galeon, Konqueror, Mozilla, Netscape and Opera are supported natively. The user can also manually enter a command to be executed when a link is clicked (%s expands to the URL). For example, xterm -e lynx "%s" will open the link with lynx. Open new window by default makes the browser use a new window instead of using the current window (or spawning a new tab).
Message Logs lets the user choose whether Conversations and/or Buddy Chats will be logged as well as whether logs will be in HTML or plain text format. System Logs describes the types of events to be logged.
Queue new messages when away: Messages received since going Away will not be shown until away status is removed.
Send auto-response: If someone messages you while away, your auto-response will be sent.
Only send auto-response when idle: If someone messages you while away, your auto-response will only be sent if Pidgin decides that the connection is idle.
Idle time reporting: If None is selected, account idle time will not be reported. Pidgin usage infers your idle time from your usage of Pidgin. X usage infers your idle time from X (this option may not be universally available).
Auto-away: Determines if and under what conditions Pidgin will automatically turn on the Away status.
Allows the user to enable add-on plugins for Pidgin. Several of these come with Pidgin, while others must be downloaded separately. The Description field gives the plugin author's description of the plugin, while the Details field gives the plugin's authorship, URL, and file name/location information.
Some plugins can be configured. If you load such a plugin, its configuration preferences will appear as a submenu to Plugins, with the submenu title determined by the plugin's name.
Protocols provide protocol specific preferences here.
Beneath the lower text box is a row of buttons that execute commands:
Additional commands available in chat, depending on the protocol are:
New Away Message provides space for one to enter an away message and a title for that message. If Save or Save & Use are chosen, this message will be saved. It can later be referred to by the title given to it.
Remove Away Message is a submenu containing the titles of saved away messages. Clicking on one of these titles will remove the away message associated with it.
The rest of the away menu provides the user with a way to assign different away messages to different connections. Choosing Set All Away will set away all the connections capable of the away state.
Before sending a bug report, please verify that you have the latest version of Pidgin. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Sean Egan (lead developer) <[email protected]>
Daniel 'datallah' Atallah (developer)
Ethan 'Paco-Paco' Blanton (developer)
Thomas Butter (developer)
Sadrul Habib Chowdhury (developer)
Mark 'KingAnt' Doliner (developer) <[email protected]>
Christian 'ChipX86' Hammond (developer & webmaster) <[email protected]>
Gary 'grim' Kramlich (developer)
Richard 'rlaager' Laager (developer) <[email protected]>
Richard 'wabz' Nelson (developer)
Christopher 'siege' O'Brien (developer)
Bartosz Oler (developer)
Etan 'deryni' Reisner (developer)
Tim 'marv' Ringenbach (developer) <[email protected]>
Luke 'LSchiere' Schierer (support)
Megan 'Cae' Schneider (support/QA)
Evan Schoenberg (developer)
Stu 'nosnilmot' Tomlinson (developer)
Nathan 'faceprint' Walp (developer)
Our crazy patch writers include:
John 'rekkanoryo' Bailey
Ka-Hing 'javabsp' Cheung
Felipe 'shx' Contreras
Peter 'Bleeter' Lawler
Robert 'Robot101' McQueen
Kevin 'SimGuy' Stange
The retired developers of gaim are:
Herman Bloggs (win32 port) <[email protected]>
Jim Duchek <[email protected]> (maintainer)
Rob Flynn <[email protected]> (maintainer)
Adam Fritzler (libfaim maintainer)
Syd Logan (hacker and designated driver [lazy bum])
Jim Seymour (Jabber developer)
Mark Spencer (original author) <[email protected]>
Eric Warmenhoven (former lead developer) <[email protected]>
This manpage was originally written by Dennis Ristuccia <[email protected]>. It has been updated and largely rewritten by Sean Egan <[email protected]> and Ben Tegarden <[email protected]>.