EVERYBUDDY
=================

Everybuddy is a chat program for X that incorporates the functions of AOL 
Instant Messenger, ICQ, Yahoo Chat, and MSN Messanger.  It's based on the 
following excellent libraries: 

	libmsn		Written by Shane P. Brady for Everybuddy Use.

	libicq		http://www.korsoft.com/gicq

	yahoolib	http://www.unixtools.com/gtkyahoo

	libtoc		Written by Torrey Searle for Everybuddy Use.


INSTALLATION:
_____________

 /*
  *
  * PLEASE NOTE:
  *
  * Compiling from CVS requires some additional development tools that
  * you may not have installed by default.  These packages include:
  * 
  *  autoconf
  *  automake
  *  libtool
  * 
  * These packages are not required if you are building from the
  * distributed source tarfile.
  *
  */

Everybuddy is in a very early stage of development.  Therefore your best bet 
is to get the latest version via CVS with the following commands:

     cvs -d ':pserver:anoncvs@marko.net:/usr/share/cvsroot' login
     CVS password: anoncvs
     cvs -d ':pserver:anoncvs@marko.net:/usr/share/cvsroot' checkout everybuddy

To compile Everybuddy, change to the Everybuddy source directory and issue 
the following commands:

     ./gen
     ./configure
     make
     make install

To execute the program run /usr/local/bin/everybuddy.


USING and CONFIGURING EVERYBUDDY:
_________________________________


Proxy Support

Everybuddy currently supports http and socks5 proxies but with the following 
limitations:

1. Neither HTTP nor SOCKS5 proxies work with ICQ

2. In order to use SOCKS5 proxy you must be on a network that is capable of
   resolving DNS hostnames.



Telling Everybuddy about yourself:

The first time you execute Everybuddy, you will be presented with a dialog box 
that welcomes you and asks you for your AOL IM handle and the corresponding 
password.  If you have multiple AOL IM handles or an ICQ UIN (or multiple UINs)
then press the add button prior to selecting ok.  This will give you the 
opportunity to add your additional handles/UINs.  Optionally, handles/UINs can 
be added by selecting "Edit Accounts" from the tools menu.  Be forewarned that 
for the time being the function for registering a new ICQ or AOL IM account has
not be implemented.  Therefore, you must already have a preexisting ICQ or 
AOL IM account with the appropriate servers.


Telling Everybuddy about your friends:

While Everybuddy may look like AOL IM, the CONTACT LIST (a.k.a. buddy list) is 
based on a different paradigm than either AOL IM or ICQ so that it can 
accommodate the various massaging protocols.  It works very well but takes some
getting used to.  In a nutshell, there are GROUPS, CONTACTS and ACCOUNTS.  A 
GROUP is just an arbitrary classification of CONTACTS. You could set up a 
GROUP called "buddies" or perhaps a GROUP called "family" or even "coworkers".
CONTACTS are individuals.  However, a CONTACT may have multiple ACCOUNTS 
(i.e. a AOL IM account and a ICQ account).

An example:

Dick's AOL IM handle is:    Dicks_AOL_IM_handle
Dick's ICQ UIN is:          101010101

Jane's AOL IM handle is:    Janes_AOL_IM_handle
Jane's ICQ UIN is:          010101010

Dick still uses windows and is stuck with using two different clients but 
Jane, being the very sophisticated and hip linux user that she is, decides to 
save valuable desktop space by using Everybuddy.  Unlike many men, she's not 
too proud to read the documentation (including the FAQ) and learns how to 
download Everybuddy from CVS, compile and install it, and how to tell 
Everybuddy about herself.  Then she starts to edit her CONTACT LIST by
selecting the appropriate tab in the GUI.  First she pushes the ADD button 
and creates a new GROUP called, "friends".  Once the GROUP is created.  Then 
she needs to ADD a CONTACT. The CONTACT can be a more descriptive name then 
just merely a handle.  So she pushes the ADD button (on the EDIT CONTACTS tab) 
again and selects the ADD CONTACT tab.  She names her contact "Dick" and 
considering him a friend and knowing that he prefers to use AOL IM, she selects
the "friends" GROUP and AIM as the default protocol to use when messaging
Dick.  After pressing ok, Jane pushes the ADD button (on the EDIT CONTACTS tab)
a third time to add Dick's AOL IM ACCOUNT.  She selects the ADD ACCOUNTS tab 
and makes sure "Dick" is the selected CONTACT.  She enters his ACCOUNT as 
"Dicks_AOL_IM_handle" and selects "AIM" as the protocol for this ACCOUNT.  
Lastly, she goes the steps of creating another ACCOUNT for the CONTACT, "Dick" 
so that she can also use ICQ to message Dick.  Instead of putting in his 
handle, she puts in his UIN and selects the ICQ protocol.

If Dick sends a message to Jane via AOL IM, then she will receive the message 
from her CONTACT "Dick".  Likewise, if Dick sends a message to Jane via ICQ, 
it will still appear to be coming from "Dick" regardless of his AOL IM handle 
or ICQ nickname.

Users of GAIM can forego some of these steps by making use of a function from 
the TOOLS menu to import an exported ~/gaim.buddy list.

If you haven't found the answers you are looking for in this document, then 
please try reading the FAQ <http://www.everybuddy.com/faq.shtml>
