NAME 

Gaim-Text - A Pimpin' Penguin console frontend for Instant Messaging client Gaim.

SYNOPSIS 

gaim-text [options]

DESCRIPTION 

gaim-text is a console-based modular messaging client capable of using AIM, MSN, Yahoo!, Jabber, 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. Gaim is not endorsed by or affiliated with America Online, ICQ, Microsoft, or Yahoo.

OPTIONS 

The following options are provided by gaim-text using the standard GNU command line syntax:
-d, --debug
Print debugging messages to stderr and start with the Debug window. The messages shown in the Debug window are the same as the ones printed in stderr.
-c, --config=DIR
Use DIR as the directory for config files instead of ~/.gaim.
-h, --help
Print this help and exit.
-n, --nologin
Don't automatically login when gaim-text starts. Sets all accounts to Offline.
-v, --version
Display the version information window.

GNT Shortcuts 

You can use the following shortcuts:
Alt + a
Bring up a list of available actions. You can use this list to access the accounts window, plugins window, preference window etc.
Alt + n
Go to the next window.
Alt + p
Go to the previous window.
Alt + w
Show the list of windows. You can select and jump to any window from the list.
Alt + c
Close the current window.
Alt + q
Quit.
Alt + m
Start moving a window. Press the cursor keys to move the window. When you are done, press Enter or Escape.
Alt + r
Start resizing a window. Press the cursor keys to resize the window. When you are done, press Enter or Escape.
Alt + d
Dump the contents of the screen in HTML format in a file named "dump.html" in working directory.
Alt + .
Move the position of the current window in the window list one place to the right.
Alt + ,
Move the position of the current window in the window list one place to the left.
Alt + l
Refresh the windows. This is useful after resizing the terminal window.
Alt + 1 2 ... 0
Jump to the 1st, 2nd ... 10th window.
Ctrl + o
Bring up the menu (if there is one) for a window. Note that currently only the buddylist has a menu.

FILES 

~/.gntrc: configuration file for gnt applications.
A sample file looks like:
[general] shadow = 0 # There is experimental mouse support mouse = 1 # To use some custom window-manager wm = /usr/local/lib/gaim/s.so

[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 title = white; blue titled = white; gray 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

Widget Actions 

You can specifiy key-bindings for specific widgets. The following entries in ~/.gntrc correspond to the default keybindings for the actions:

[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 left = cursor-prev right = cursor-next tab = suggest-show down = suggest-next up = suggest-prev # The following actions don't have any default binding: # delete-prev-word # cursor-prev-word

[GntTree::binding] up = move-up down = move-down c-n = move-down c-p = move-up pageup = page-up pagedown = page-down

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.

Mouse Support 

There is experimental mouse support. You can focus windows, activate buttons, select rows in a list, scroll using the wheel-scroll etc. Mouse support is disabled by default, so you need to enable it in ~/.gntrc (see the sample above).

Window Management 

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.

Conversation Commands 

There are a few helpful commands in addition to the regular commands. You can use these from any conversation to access other windows.
accounts
for the accounts window.
buddylist
for the buddylist.
debugwin
for the debug window.
plugins
for the plugins window.
prefs
for the preferences window.
status
for the status window.

BUGS 

Known bugs are listed at

PATCHES 

If you fix a bug in gaim-text (or otherwise enhance it), please submit a patch (using svn diff > my.diff against the latest SVN version) at

Before sending a bug report, please verify that you have the latest version of gaim-text and libgaim. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved.

You are also encouraged to drop by at #gaim on irc.freenode.net to discuss about development.

SEE ALSO 

LICENSE 

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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

AUTHORS 

Sadrul Habib Chowdhury <>

This manpage was written by Sadrul Habib Chowdhury <> and Dennis Ristuccia <>.