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
|
LICQ v0.76
An ICQ clone written in C and C++ using a plugin system to allow for
many possible interfaces.
See the webpage (http://www.licq.org) for more information.
Licq implements messages (online and offline), urls, chat, full file
transfer, gui configuration (with the qt-gui plugin), history as
well as a number of other features.
LICENSE
This program is licensed under the terms of the GNU GPL, a copy
of which you should have received with this package.
INSTALLATION:
(If you have a binary distribution then see the FAQ for how to
do a manual install. Don't worry it's very easy, any monkey
could do it.)
As root:
1. Type './configure' and it will determine all the right settings and
directories for your system.
2. Type 'make' and in theory it will build. If you are using a non-GNU system,
such as FreeBSD or Solaris, you will need the GNU version of make, often
installed as `gmake'. If you get errors about "void *" see the FAQ.
3. Type 'make install' and licq will be installed (defaults to
/usr/local).
4. Go to plugins/qt-gui and follow the directions there (doc/README) to install
the Qt interface plugin (necessary).
As each user:
5. When you run licq for the first time it will install all the necessary
files in ~/.licq.
6. You can import users from a number of other clients into Licq using
one of the conversion scripts found on the download section of the web
page or in the licq-data package.
SOCKS5 Proxy Support:
Licq supports SOCKS5 proxies. To enable this support, run configure with
--enable-socks5, and optionally --with-socks5-inc=PATH and
--with-socks5-lib=PATH. Then just make sure all the right environment
variables are set and it should work. Also read the SOCKS.HOWTO file.
Licq requires the following:
Some C++ compiler with proper standard c++ headers.
Licq has been compiled and run successfully on the following systems at one
point (note current versions may no longer compile without a bit of tweaking):
Linux/x86
Linux/Alpha
Linux/PPC
FreeBSD/i386
AIX/RS6000
NetBSD/mk68000
Sun3/mk68000
Solaris/x86
Unixware
Solaris/sparc
CONFIGURATION:
Configuration is done through the ~/.licq/licq.conf file, which contains .ini
style options. Help on each option is include in the file. The contact
list is stored in conf/users.conf. Each users info is stored as a simple
text file called {user uin}.uin. Again, the options are pretty obvious.
You can add/remove/edit a user inside the gui, or by editing the conf files.
The History file is the file where the user history is stored...you can
specify a filename for each user, or you can put one of the following
keywords:
none : no history file
default : makes the history file history/<uin>.history
USE:
Type licq -h for commandline help.
Using licq is fairly straight-forward. Licq itself is merely a daemon
designed to run various plugin interfaces. I have written an advanted
gui in qt (qt-gui) which should be used as the default plugin. Once you
have compiled and installed Licq, unpack the plugins you wish to use into
the plugins/ directory, compile them, and then install them into
/usr/local/share/licq/plugins (replace /usr/local with the prefix given
to configure if necessary). Then start licq with the -p option:
$ licq -p qt-gui -- ...any options to the plugin...
Note the -- which tells the system to pass any options after that on to the
first plugin in the list. Multiple plugins can be chained in this way:
$ licq -p qt-gui -p email-forward -- <qt-gui options> -- <email-forward options>
PROBLEMS:
See the BUGS file for reports on known bugs and problems.
TROUBLE-SHOOTING:
1. RUNNING
o Segfault at startup. If this occurs, run licq with the -d 15 switch and tell
me how far it gets before segfaulting and I'll try and help.
Good luck.
CONTACTS:
Send any questions, comments, or other complaints to graham@licq.org,
uin 2127503
|