alicq(1)

NAME

alicq - Flexible ICQ client in pure Tcl/Tk

SYNOPSIS

alicq [ options ]

DESCRIPTION

Alicq is pure Tcl/Tk implementation of ICQ (www.icq.com) client with flexible modularized architecture, support for ICQv8 (ICQ2000/OSCAR) protocol.

OPTIONS

Alicq supports standard options, which are understandable by wish(1), as well as it's own specific options.

Most important options are:

-display display: Use specified X window display instead of one, specified in DISPLAY environment variable

-geometry geometry_specification: Initial geometry for contact list window

-config name_of_startup_file: Use specified startup file instead of default one

-info [ modules ]: Show metainformation on given module or all loaded modules

-xmlinfo [ modules ]: Show metainformation on given module or all loaded modules in XML format

-version: Show alicq version and exit

-help: Show list of supported command-line options and exit

X RESOURCES

As any well-behaved X application (and in difference to licq, gicq and other gtk/qt clients) Alicq can be configured using X RESOURCE database.

Resources specified in the .alicqrc" file (see alicqrc(5)) using option add command by default take precedence over resourses in the resource database. If it is not desirable (for instance, in multi-terminal configuration where display-specific resources should override host-wide defaults) you should add keyword "widgetDefault" or "startupFile" to each option add command in your .alicqrc. Most commonly used resources are:

Alicq-specific resources

Alicq*quickPanel true|false: Specifies should toolbar be displayed in contact list window. Default is true

Alicq*dateFormat date-format: Format to display date in message dialogs. Time format can be any value acceptable by clock(n) or strftime(3) commands. Default value is %x

Alicq*timeFormat time-format: Time format to display time in message dialogs. Time format can be any value acceptable by clock(n) or strftime(3) commands. Default value is %X

Alicq*Text.headerBackground color: Background of message header in message dialogs. Default value is gray85

Alicq*Text.headerRelief relief: Relief of message header in message dialogs.

Alicq*Text.headerFont font: Font of message header in message dialogs.

Alicq*Text.underlineTag tag-spec: Can accept one of the values alias, header, or empty string. Specifies which part of message header should be underlined. Default is alias

Alicq*Text.incomingColor color: Color of incoming messages. Default is darkMagenta

Alicq*Text.outgoingColor color: Color of outgoing queued, but not sent messages. Default is red

Alicq*Text.sentColor color: Color of outgoing sent, but not acknowledged messages. Default is darkGray

Alicq*Text.clientColor color: Color of sent and acknowledged by client messages. Default is darkBlue

Alicq*Text.serverColor color: Color of sent and acknowledged by server messages. Default is SteelBlue

Alicq*Text.urlColor color: Color of URLs. Default is blue

Alicq*.rosterContactColor color: Color of contacts stored in server-side roster. Default is black

Alicq*.localContactColor color: Color of contacts stored only in local roster. Default is blue

Standard Tk resources

Alicq*Text.font font-specification: font for multiline text entry areas

Alicq*Entry.font font-specification: font for single-line text entry areas

Alicq*TreeNode.font font-specification: contact list font

Alicq*tr.c.background color-specification: contact list background color

Alicq*tr.c.fill color-specification: contact list foreground color

Alicq.AlicqUserWindow*Text.resource resource-specification: where resource is one of font, background, foreground, etc - parameters of the user window.

Alicq*msgContact-UIN-UIN*Text.resource resource-specification: Specify resource for dialog window of contact UIN only

More resource names for Alicq widgets can be found in options(n), text(n), button(n) man pages.

INTERACTION WITH OTHER PROGRAMS

Alicq can be controlled from command line, by using powerfull Tcl/Tk command send(n), supported by wish(1). This allows other programs to send commands to Alicq.

Examples:

echo 'send alicq {Event SetStatus online};exit'| /usr/bin/wish -display :0

This line, added to file makes Alicq connect to server when ppp interface is up.

echo 'send alicq {Event Send text Contact:ICQ:UIN "Something happened"};exit'| wish

This line allows any script send notification messages to ICQ.

FILES

$HOME/.alicq/alicqrc: Default startup file for Unix version of Alicq.

$HOME/.alicqrc: Startup file of older versions of Alicq. Used for backward compatibility.

AUTHORS

Alicq was written by Ihar Viarheichyk <[email protected]>.

This manual page was written by Dmitry Borodaenko <[email protected]>, based on Alicq README and slightly reworked by Vitus Wagner <[email protected]> and Ihar Viarheichyk <[email protected]>.

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.