File: README

package info (click to toggle)
alicq 0.6.1-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 412 kB
  • ctags: 195
  • sloc: tcl: 2,703; makefile: 39
file content (159 lines) | stat: -rw-r--r-- 5,637 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

                                   Alicq
                       http://alicq.sourceforge.net/

INTRODUCTION

   Alicq is pure Tcl/Tk implementation of ICQ client with flexible
   modularized architecture, support for ICQv8 (ICQ2000/OSCAR) protocol,
   and ability to pick up Licq configuration files and user database.

   Why would you use it? It is small, about 2500 lines as of release
   0.6. It is modular and extendable in best tradition of the Tcl
   scripting language. New modules are easy to write, and dozen lines
   Tcl module can do a lot. It is crossplatfrom: works on Unix, Windows,
   Macintosh, and on any other system supported by Tcl/Tk.


FEATURES

     * New ICQv8 (ICQ2000/OSCAR) TCP-based protocol that works better
       than older UDP-based protocol versions
     * Most functionality is divided into independent modules, which can
       be included/excluded from config file
     * New modules for extended functionality are easy to write
     * Send and receive online and offline messages
     * Receive URLs
     * Send authorization on request
     * Change personal info, get contact info, search ICQ whitepages
     * Connect through HTTP proxy
     * Look at MODULES section below to see features of available
       modules


INSTALL

     * Unix:

   Make sure you have tcl, tk (8.3 or greater) and bwidget installed. To
   connect through HTTP proxy with authorization, install tcllib. To
   play sounds on incoming messages, install sox. To try experimental
   OpenPGP encryption support, install GnuPG.

	tar xzf alicq.tar.gz
	cd alicq
	./alicq.tcl

   At that point it will parse your .licq/ (if you have one) and start
   working. If you don't have Licq or want to configure Alicq, copy
   alicqrc.example to ~/.alicqrc or ~/.alicq/alicqrc, and edit it to get
   configuration you like. You can also use tools/convert.tcl to convert
   your Licq contacts to Alicq format.

     * Windows:

   In Windows, you should get ActiveTcl installed (it includes bwidget),
   and put configuration file with name alicq.cfg at %USERPROFILE%\alicq
   or at Alicq starting directory. (%USERPOFILE% points to folder with
   user settings in Windows NT/2000.)

     * Macintosh:

   No one tried yet.


INTERFACE

   Alicq Main window shows your contact list in groups. To move user
   from one group to another, drag-and-drop her to the target group's
   title.

   There are two menus available at the bottom of the Main Window, both
   can be opened with F10 key. Icon menu on the left represents your
   status: Online, Away, Do Not Disturb, Occupied, Free For Chat, Not
   Available, Offline; in that order. Menu on the right allows to access
   ICQ whitepages, add users and groups, and set interface options. To
   quickly show and hide offline users, press Ctrl-O.

   Double-click or press Enter on any user to open a User dialog, where
   you can type and send messages to the user, and where messages from
   the user are displayed. Following actions are available:

     * click on 'Send' or press Ctrl-Enter to send message
     * click on 'Cite' to quote previous message from this user
     * click on 'History' to see past messages from that user
     * click on 'Cancel' or press Esc to close User window

   Right-click on a contact to open a context menu, where you can choose
   to send special type of message (Authorization, URL, or SMS), change
   your visibility to this user (Visible means that you are visible to
   this user when you are in Invisible mode, Invisible means that you
   are invisible to this user even when you are Online), view user info
   and message history, rename or delete user from contact list.

   Enjoy the simplicity!


MODULES

   You can load and configure existing modules from config file, or
   write your own (read modules-devel.txt to learn more about Alicq
   modules development).

   GUI modules:
     * base.tcl: basic GUI module
     * colorer.tcl: colorize incoming and outgoing messages
     * sound.tcl: play sound on incoming messages
     * url.tcl: highlight URLs and handles clicks on them
     * whitepages.tcl: change personal info, get contact info, search
       ICQ whitepages
     * wmdock.tcl: primitive WindowMaker dock applet

   Utility modules:
     * encoding.tcl: automatic character set detection (based on user
       locale settings) and translation
     * licq.tcl: Licq configuration parser module allows to
       automagically pick up Licq configuration and user database, write
       Licq history files and Licq config files when contacts added or
       moved between groups
     * antispam.tcl: filter out messages that contain specified words,
       from UINs not on your contact list


ADVANCED

   You can play with running Alicq from the command line. Just feed the
   commands like this:

	echo "send alicq {set base::TimeFormat {%X}};exit"|wish

   or this:

	echo "send alicq {icq::SendMessage <UIN> hi};exit"|wish

   where <UIN> should be replaced with numeric UIN of the recipient.
   Remember that you can't change effect of module options that are not
   traced in the program (look for 'trace variable' in the code).

   You can also change appearance of Alicq with X resources. Just put
   something like this into your .Xdefaults:

	Alicq*geometry: 150x768-0+64
	Alicq*Text.font: karev
	Alicq*Entry.font: karev

   and run xrdb to re-read the resource database. When you run Alicq
   next time, it will show up in the long window on the right edge of
   you desktop.


CONTACT

Author:

Ihar Viarheichyk <iverg@mail.ru> (ICQ UIN 47298730)

Contributors:

Dmitry Borodaenko <angdraug@debian.org>