alicq1

Usage

Overview

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

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