Alicq (1)

I. Name

alicq - Flexible ICQ client in pure Tcl/Tk

III. Description

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

IV. 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

V. 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.

VI. 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.

VII. 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.

VIII. See Also

alicqrc (5), options (n), wish (1), text (n)

/usr/share/doc/alicq/README.gz

/usr/share/doc/alicq/examples/alicqrc.example.gz

Alicq home page

IX. Authors

Alicq was written by Ihar Viarheichyk.

This manual page was written by Dmitry Borodaenko, based on Alicq README and slightly reworked by Vitus Wagner and Ihar Viarheichyk.

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.