finch is a console-based 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 following options are provided by finch using the standard GNU command line syntax:
You can use the following shortcuts (see the "Widget Actions" section for a more complete list):
~/.gntrc: configuration file for gnt applications.
[general] shadow = 0 # There is experimental mouse support mouse = 1 # To use some custom window-manager wm = /usr/local/lib/gnt/s.so # There's also a custom window manager called irssi.so # Remember window-positions based on the titles (on by default) remember_position = 1 # Use borderless one-line high buttons small-button = true
# Workspaces are created simply by adding Workspace-X groups as follows: [Workspace-1] name = blist # window-names specifies that windows with these semi-colon separated names are placed into this workspace window-names = buddylist;debug-window
[Workspace-2] name = IM window-names = conversation-window # window-titles specifies that windows with these semi-colon separated titles are placed into this workspace. These are matched as substrings. Window titles take precedence over names. window-titles = Preferences;Pounce
[colors] # The RGB values range in [0, 1000] black = 0; 0; 0 red = 1000; 0; 0 green = 0; 1000; 0 blue = 250; 250; 700 white = 1000; 1000; 1000 gray = 700; 700; 700 darkgray = 256; 256; 256
[colorpairs] normal = white; black highlight = white; blue highlightd = black; gray shadow = black; darkgray title = white; blue titled = white; gray text = white; blue disabled = gray; black urgent = green; black
# Remap some keys for GntEntry [GntEntry::remap] # Remap the up-arrow to the left-arrow ^[[A = ^[[D # Remap the down-arrow to the right-arrow ^[[B = ^[[C # Remap 'a' to 'bcd' a = bcd # Completely ignore the key 'q' q = # But the following will NOT work #abc = bcd
# Hitting 'space' will activate a button [GntButton::remap] \ = \r
You can specifiy key-bindings for specific widgets. The following entries in ~/.gntrc correspond to the default keybindings for the actions:
[GntBox::binding] tab = focus-next right = focus-next left = focus-prev
[GntComboBox::binding] down = dropdown up = dropdown
[GntEntry::binding] c-a = cursor-home home = cursor-home c-e = cursor-end end = cursor-end backspace = delete-prev del = delete-next c-d = delete-next c-u = delete-start c-k = delete-end c-b = cursor-prev left = cursor-prev c-f = cursor-next right = cursor-next tab = suggest-show down = suggest-next up = suggest-prev page-down = suggest-next-page page-up = suggest-prev-page c-w = delete-prev-word a-b = cursor-prev-word a-f = cursor-next-word a-d = delete-next-word c-v = clipboard-paste c-p = history-prev c-n = history-next c-r = history-search c-up = history-prev c-down = history-next
[GntTree::binding] up = move-up down = move-down c-n = move-down c-p = move-up pageup = page-up pagedown = page-down backspace = move-parent home = move-first end = move-last # Following is the default binding for the context-menu menu = context-menu # The following will let you open the context-menu in the buddylist with c-b # c-b = context-menu
[GntWidget::binding] f11 = context-menu c-x = context-menu
[GntWindow::binding] c-o = show-menu f10 = show-menu
The c- corresponds to the Control key. You can also use ctrl- or ctr- or ctl- to indicate a combination. For alt-keys, you can use one of a-, alt-, m- or meta-. You can also use home, end, left, right etc. keys.
To unbind a key which has a default binding, you simply bind it to the empty string. For example, to unbind Alt + q from the Quit function, you would use:
[GntWM::binding] a-q =
You can also specify key-bindings to trigger specific menuitems in windows. For example, the following entry in ~/.gntrc will bind Ctrl + t to the 'Send IM...' item in the buddylist:
[buddylist::menu] c-t = send-im
The following is the list of IDs of the current menuitems in the buddylist:
send-im join-chat show-empty-groups show-offline-buddies sort-status sort-alpha sort-log add-buddy add-chat
There is experimental mouse support. You can focus windows, activate buttons, select rows in a list, scroll using the wheel-scroll etc. Selecting text in a text-view copies it to the gnt clipboard. Mouse support is disabled by default, so you need to enable it in ~/.gntrc (see the sample above).
The default window management is very limited. But it is possible to write custom window managers to suit your needs. There is a sample window-manager included (named s.so) which adds a little 'close-button' for the windows, removes the borders from the buddylist and pops up new windows in the middle of the screen, instead of at the upper-left corder. It is provided as a sample simple manager, but it should be possible to write more complex managers, and it's very possible that the window-manager API will need to be enhanced. Look at the sample ~/.gntrc file above to see how to select a window-manager.
It is also possible to rebind the window-manager actions in ~/.gntrc, eg:
[GntWM::binding] a-n = window-next a-p = window-prev a-c = window-close a-w = window-list a-d = dump-screen a-, = shift-left a-. = shift-right a-a = action-list a-m = start-move a-r = start-resize a-q = wm-quit a-l = refresh-screen a-s = workspace-list a-t = window-tag a-T = place-tagged a-C = toggle-clipboard a-/ = help-for-widget a-c-j = window-scroll-down a-c-k = window-scroll-up # The following action is still incomplete, and doesn't have a default binding # switch-window-n # Other actions: window-next-urgent, window-prev-urgent
# For the sample custom window manager [GntS::binding] a-b = toggle-buddylist
# For the irssi window manager [Irssi::binding] a-L = move-right a-H = move-left a-J = move-down a-K = move-up
There are a few helpful commands in addition to the regular commands. You can use these from any conversation to access other windows.
FAQ for finch is located at
Known bugs are listed at
Before sending a bug report, please verify that you have the latest version of finch and libpurple. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved.
If you fix a bug in finch (or otherwise enhance it), please submit a patch (using mtn diff > my.diff against the latest version from the Monotone repository) at http://developer.pidgin.im/simpleticket
You are also encouraged to drop by at #pidgin on irc.freenode.net to discuss development.
http://pidgin.im/ http://developer.pidgin.im/ purple-remote(1) pidgin(1)
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
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., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
Sadrul Habib Chowdhury <email@example.com>
This manpage was written by Sadrul Habib Chowdhury <firstname.lastname@example.org> and Dennis Ristuccia <email@example.com>.