.\" Copyright (c) 2006, Sadrul Habib Chowdhury <sadrul@users.sf.net>.\".\" This is free documentation; 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..\".\" The GNU General Public License's references to "object code".\" and "executables" are to be interpreted as the output of any.\" document formatting or typesetting system, including.\" intermediate and printed output..\".\" This manual 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 manual; if not, write to the Free.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,.\" USA..TH finch 1.SH NAMEFinch \- A Pimpin' Penguin console frontend to libpurple. InstantMessaging client..SH SYNOPSIS.TP 5\fBfinch \fI[options]\fR.SH DESCRIPTION.PP\fBfinch\fR is a console-based modular messaging client based on libpurplewhich 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 hasmany common features found in other clients, as well as many unique features.Finch is not endorsed by or affiliated with America Online, ICQ, Microsoft, orYahoo..SH OPTIONSThe following options are provided by \fBfinch\fR using the standard GNUcommand line syntax:.TP.B \-d, \-\-debugPrint debugging messages to stderr and start with the \fBDebug\fR window. Themessages shown in the \fBDebug\fR window are the same as the ones printed instderr..TP.B \-c, \-\-config=\fIDIR\fBUse \fIDIR\fR as the directory for config files instead of \fI~/.purple\fR..TP.B \-h, \-\-helpPrint this help and exit..TP.B \-n, \-\-nologinDon't automatically login when \fBfinch\fR starts. Sets all accounts toOffline..TP.B \-v, \-\-versionDisplay the version information window..SH GNT ShortcutsYou can use the following shortcuts (see the "\*QWidget Actions\*U" section for a more complete list):.TP.B Alt \+ aBring up a list of available actions. You can use this list to access theaccounts window, plugins window, preference window etc..TP.B Alt \+ nGo to the next window..TP.B Alt \+ pGo to the previous window..TP.B Alt \+ wShow the list of windows. You can select and jump to any window from the list..TP.B Alt \+ cClose the current window..TP.B Alt \+ qQuit..TP.B Alt \+ mStart moving a window. Press the cursor keys to move the window. When you aredone, press \fBEnter\fR or \fBEscape\fR..TP.B Alt \+ rStart resizing a window. Press the cursor keys to resize the window. When youare done, press \fBEnter\fR or \fBEscape\fR..TP.B Alt \+ DDump the contents of the screen in HTML format..TP.B Alt \+ .Move the position of the current window in the window list one place to theright..TP.B Alt \+ ,Move the position of the current window in the window list one place to theleft..TP.B Alt \+ lRefresh the windows. This is useful after resizing the terminal window..TP.B Alt \+ 1 2 ... 0Jump to the 1st, 2nd ... 10th window..TP.B Alt \+ TabJump to the next URGENT (highlighted) window..TP.B Alt \+ Shift \+ TabJump to the previous URGENT (highlighted) window..TP.B Ctrl \+ o \fR or \fB F10Bring up the menu (if there is one) for a window..TP.B F11Popup the context menu (if there is one) for the selected widget..TP.B Alt \+ /Show a list of available key-bindings for the current widget in focus..TP.B Alt \+ \>Switch to the next workspace.TP.B Alt \+ \<Switch to the previous workspace.TP.B Alt \+ tTag (or untag) the current window.TP.B Alt \+ TAttached all the tagged windows to the current workspace.TP.B Alt \+ sShow the workspace list.TP.B F9Create a new workspace and switch to it.SH FILES\fI~/.gntrc\fR: configuration file for gnt applications..br.TPA sample file looks like:.br[Finch].brcolor-available = green; black.brcolor-away = blue; black.brcolor-idle = gray; black.brcolor-offline = red; black.brcolor-message-sent = cyan; default.brcolor-message-received = red; default.brcolor-message-highlight = black; green.brcolor-message-action = yellow; default.brcolor-timestamp = blue; default.br#See below for details on color.br[general].brshadow = 0.br# There is experimental mouse support.brmouse = 1.br# To use some custom window-manager.brwm = /usr/local/lib/gnt/s.so.br# There's also a custom window manager called irssi.so.br# Remember window-positions based on the titles (on by default).brremember_position = 1.br# Use borderless one-line high buttons.brsmall-button = true.br# Workspaces are created simply by adding Workspace-X groups as follows:.br[Workspace-1].brname = blist.br# window-names specifies that windows with these semi-colon separated names are placedinto this workspace.brwindow-names = buddylist;debug-window.br.br[Workspace-2].brname = IM.brwindow-names = conversation-window.br# window-titles specifies that windows with these semi-colon separated titles are placedinto this workspace. These are matched as substrings. Window titles take precedence overnames..brwindow-titles = Preferences;Pounce.br.br[colors].br# The RGB values range in [0, 1000].brblack = 0; 0; 0.brred = 1000; 0; 0.brgreen = 0; 1000; 0.brblue = 250; 250; 700.brwhite = 1000; 1000; 1000.brgray = 700; 700; 700.brdarkgray = 256; 256; 256.br.br[colorpairs].brnormal = white; black.brhighlight = white; blue.brhighlightd = black; gray.brshadow = black; darkgray.brtitle = white; blue.brtitled = white; gray.brtext = white; blue.brdisabled = gray; black.brurgent = green; black.br.br# Remap some keys for GntEntry.br[GntEntry::remap].br# Remap the up-arrow to the left-arrow.br^[[A = ^[[D.br# Remap the down-arrow to the right-arrow.br^[[B = ^[[C.br# Remap 'a' to 'bcd'.bra = bcd.br# Completely ignore the key 'q'.brq = .br# But the following will NOT work.br#abc = bcd.br# Hitting 'space' will activate a button.br[GntButton::remap].br\\ = \\r.br.SH Widget ActionsYou can specifiy key-bindings for specific widgets. The following entries in\fI~/.gntrc\fR correspond to the default keybindings for the actions:.br[GntBox::binding].brtab = focus-next.brright = focus-next.brleft = focus-prev.br[GntEntry::binding].brc-a = cursor-home.brhome = cursor-home.brc-e = cursor-end.brend = cursor-end.brbackspace = delete-prev.brdel = delete-next.brc-d = delete-next.brc-u = delete-start.brc-k = delete-end.brc-b = cursor-prev.brleft = cursor-prev.brc-f = cursor-next.brright = cursor-next.brtab = suggest-show.brdown = suggest-next.brup = suggest-prev.brc-w = delete-prev-word.bra-b = cursor-prev-word.bra-f = cursor-next-word.bra-d = delete-next-word.brc-v = clipboard-paste.br[GntTree::binding].brup = move-up.brdown = move-down.brc-n = move-down.brc-p = move-up.brpageup = page-up.brpagedown = page-down.brbackspace = move-parent.br# Following is the default binding for the context-menu.brmenu = context-menu.br# The following will let you open the context-menu in the buddylist with c-b.br# c-b = context-menu.br[GntWidget::binding].brf11 = context-menu.brc-x = context-menu[GntWindow::binding].brc-o = show-menu.brf10 = show-menuThe \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fRor \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can useone of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use\fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys.To unbind a key which has a default binding, you simply bind it to the empty string. For example, to unbind \fBAlt + q\fR from the Quit function, you would use:[GntWM::binding].bra-q =.SH MenusYou can also specify key-bindings to trigger specific menuitems in windows. For example, the following entry in \fI~/.gntrc\fR will bind \fBCtrl + t\fR to the 'Send IM...' item in the buddylist:[buddylist::menu].brc-t = send-imThe following is the list of IDs of the current menuitems in the buddylist:send-im.brjoin-chat.brshow-empty-groups.brshow-offline-buddies.brsort-status.brsort-alpha.brsort-log.bradd-buddy.bradd-chat.bradd-group.SH Mouse SupportThere is experimental mouse support. You can focus windows, activate buttons,select rows in a list, scroll using the wheel-scroll etc. Selecting text in atext-view copies it to the gnt clipboard. Mouse support is disabled by default,so you need to enable it in \fI~/.gntrc\fR (see the sample above)..SH Window ManagementThe default window management is very limited. But it is possible to writecustom window managers to suit your needs. There is a sample window-managerincluded (named \fIs.so\fR) which adds a little 'close-button' for the windows,removes the borders from the buddylist and pops up new windows in the middle ofthe screen, instead of at the upper-left corder. It is provided as a samplesimple manager, but it should be possible to write more complex managers, andit's very possible that the window-manager API will need to be enhanced. Look atthe sample \fI~/.gntrc\fR file above to see how to select a window-manager.It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg:.br[GntWM::binding].bra-n = window-next.bra-p = window-prev.bra-c = window-close.bra-w = window-list.bra-d = dump-screen.bra-, = shift-left.bra-. = shift-right.bra-a = action-list.bra-m = start-move.bra-r = start-resize.bra-q = wm-quit.bra-l = refresh-screen.bra-s = workspace-list.bra-t = window-tag.bra-T = place-tagged.bra-C = toggle-clipboard.bra-/ = help-for-widget.br# The following action is still incomplete, and doesn't have a default binding.br# switch-window-n.br# Other actions: window-next-urgent, window-prev-urgent# For the sample custom window manager.br[GntS::binding].bra-b = toggle-buddylist# For the irssi window manager.br[Irssi::binding].bra-L = move-right.bra-H = move-left.bra-J = move-down.bra-K = move-up.SH Conversation CommandsThere are a few helpful commands in addition to the regular commands. You canuse these from any conversation to access other windows..TP.B accountsfor the accounts window..TP.B buddylistfor the buddylist..TP.B debugwinfor the debug window..TP.B pluginsfor the plugins window..TP.B prefsfor the preferences window..TP.B statusfor the status window..SH FAQFAQ for \fBfinch\fR is located at.br\fIhttp://developer.pidgin.im/wiki/Using%20Finch\fR.SH BUGSKnown bugs are listed at.br\fIhttp://developer.pidgin.im/query?status=new&status=assigned&status=reopened&component=finch+%28gnt%2Fncurses%29&order=priority\fRBefore sending a bug report, please verify that you have the latestversion of \fBfinch\fR and libpurple. Many bugs (major and minor) arefixed at each release, and if yours is out of date, the problem may already havebeen solved..SH PATCHESIf you fix a bug in \fBfinch\fR (or otherwise enhance it), please submit apatch (using \fBmtn diff > my.diff\fR against the latest version from theMonotone repository) at \fIhttp://developer.pidgin.im/simpleticket\fRYou are also encouraged to drop by at \fB#pidgin\fR on \fIirc.freenode.net\fRto discuss development..SH SEE ALSO\fIhttp://pidgin.im/\fR.br\fIhttp://developer.pidgin.im/\fR.br\fBpurple-remote\fR(1).br\fBpidgin\fR(1).SH LICENSEThis program is free software; you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe 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\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNUGeneral Public License for more details.You should have received a copy of the GNU General Public Licensealong with this program; if not, write to the Free SoftwareFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA.SH AUTHORSSadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR>.brThis manpage was written by Sadrul Habib Chowdhury<\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia<\fIdennis@dennisr.net\fR>.