home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / aicq016.zip / aicq.txt < prev    next >
Text File  |  1999-03-09  |  11KB  |  395 lines
  1. *************************
  2. ** A(nother) ICQ clone **
  3. *************************
  4.  
  5. Another ICQ clone for OS/2...
  6.  
  7. Copyright (C) 1998-99 by Pavel Nikiforov (pavel@intsys.ru)
  8.  
  9. Read this document before using AICQ !
  10.  
  11. This is native (no emx runtime required) os/2 clone of ICQ. This version can
  12. send/receive messages, search users, get information on user....
  13.  
  14. This programm is textmode client for Mirabilis ICQ.
  15.  
  16. Sorry for my bad English...
  17.  
  18. Legal information
  19. -----------------
  20. I have not disassembled, decompiled and reverse engeneered Mirabilis software
  21. (ICQ client) to create this programm. Only tcp/udp packets traceing and
  22. "Unofficial ICQ specification" by Magnus Ihse (d95-mih@nada.kth.se) was used.
  23. Also, this program and I are in no way affiliated with Mirabilis.
  24.  
  25. About programm
  26. --------------
  27. This programm implements virsion 2 of ICQ protocol. You can't register a new
  28. UIN using this version of AICQ, but AICQ can handle many differend users and
  29. UINs with individual options (e.g. contact list). This version of AICQ requires
  30. to run in non-fullscreen session.
  31.  
  32. License
  33. -------
  34. This programm if freeware.
  35.  
  36. LICENSE AGREEMENT
  37.  
  38. This program is for personal and non-commercial use only !
  39.  
  40. By using this programm you accept the terms of this license agreement.
  41.  
  42. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS. THE AUTHOR MAKES NO
  43. WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THOSE OF
  44. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THIS
  45. SOFTWARE. THE AUTHOR DOES NOT WARRANT, GUARANTEE OR MAKE ANY REPRESENTATIONS
  46. REGARDING THE USE OR THE RESULTS OF THE USE OF THIS SOFTWARE, IN TERMS OF THE
  47. ACCURACY, RELIABILITY, QUALITY, VALIDITY, STABILITY, COMPLETENESS,
  48. CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK OF USING THIS SOFTWARE IS ASSUMED
  49. BY THE USER.
  50.  
  51. IN NO EVENT WILL THE AUTHOR BE LIABLE TO ANY PARTY (i) FOR ANY DIRECT,
  52. INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING,
  53. BUT NOT LIMITED TO, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
  54. INTERRUPTION, LOSS OF PROGRAMS OR INFORMATION, AND THE LIKE), OR ANY OTHER
  55. DAMAGES ARISING IN ANY WAY OUT OF THE AVAILABILITY, USE, RELIANCE ON, OR
  56. INABILITY TO USE THIS SOFTWARE, EVEN IF THE AUTHOR HAVE BEEN ADVISED OF THE
  57. POSSIBILITY OF SUCH DAMAGES, AND REGARDLESS OF THE FORM OF ACTION, WHETHER
  58. IN CONTRACT, TORT, OR OTHERWISE;
  59.  
  60. OR (ii) FOR ANY CLAIM ATTRIBUTABLE TO ERRORS, OMISSIONS, OR OTHER
  61. INACCURACIES IN, OR DESTRUCTIVE PROPERTIES OF ANY INFORMATION.
  62.  
  63. Copyright
  64. ---------
  65.  
  66. Some features of AICQ developed by me and may based on wishlist of AICQ.
  67. If you will use these (special) features in your programms (and in original
  68. version of ICQ by Mirabilis), please contact me or author of this feature.
  69.  
  70. Special features:
  71.  
  72. "Income message scrolling","Message quoting"
  73.  
  74.  
  75. BETA
  76. ----
  77. This version is beta, and it have to be unstable and gluckly. About bugs write
  78. to aicq@intsys.ru
  79.  
  80. New versions
  81. ------------
  82. Official FTP site of AICQ: ftp.intsys.ru/pub/aicq
  83.  
  84. Mirrors in Russia:
  85.  
  86. Samara:
  87. ftp.kraft-s.ru/pub/software/os/os2/internet/icq/
  88.  
  89. Mirror in USA:
  90. ftp.blackpalace.com/
  91.  
  92. I'm planning to create a GUI version of this programm... If you can help,
  93. write me.
  94.  
  95. Command line options
  96. --------------------
  97.  
  98. /c <config file> - use another config file, insetad of aicq.conf, for
  99.            example if longname is not suitable.
  100.  
  101. /nopm - not make AICQ PM application. It will disable window positioning 
  102.         and switching to aicq when receive message.
  103.  
  104. /debug - debug mode.
  105.  
  106. Config files
  107. ------------
  108. The main config file is aicq.conf, and it have to be located in the same
  109. directory, where aicq.exe is. The format is like this:
  110.  
  111. -- CUT --
  112.  
  113. ; Main options, for all users
  114. [AICQ]
  115. ; Default user is User1 (User1 is a nickname)
  116. DefaultUser=User1
  117. ; Check new version when login !
  118. CheckNewVersion=True
  119.  
  120. ; User defined status (for new versions of ICQ)
  121. ; If you don't like to see somebody[00030200] in online list
  122. ; (30200 his status in hex), ask what status this user is now,
  123. ; and update corresponding line below. All numbers MUST be hex
  124. ; like AICQ display them, many numbers are escaped by ","
  125. Status.Online=30200
  126. Status.Offline=
  127. Status.Away=
  128. Status.FFC=
  129. Status.DND=
  130. Status.NA=
  131. Status.Occupied=
  132. Status.Invisible=
  133.  
  134. ; Options for User1
  135. [User1]
  136. ; UIN and password of user
  137. UIN=xxxxxxxx
  138. Password=xxxxxxxxx
  139.  
  140. ; Your first name
  141. FName=Pavel
  142. ; Your last name
  143. LName=Nikiforov
  144. ; Your e-mail
  145. EMail=pavel@intsys.ru
  146.  
  147. ; Server and port to connect
  148. Server=icq.mirabilis.com
  149. Port=4000
  150.  
  151. ;More servers
  152. Server1=icq1.mirabilis.com
  153. Server2=icq2.mirabilis.com
  154. Server3=icq3.mirabilis.com
  155. Server4=icq4.mirabilis.com
  156. Server5=icq5.mirabilis.com
  157. Server6=icqalpha.mirabilis.com
  158. ; Select random server each time
  159. RandomServer=True
  160.  
  161. ; Contact list file name
  162. Contacts=./contacts
  163. ; Invisible list file name, format the same as contact list file
  164. Invisible=./invisible
  165. ; Visible list file name, format the same as contact list file
  166. Visible=./invisible
  167.  
  168. ; Maximize window on start (False/True)
  169. MaximizeOnStart=True
  170.  
  171. ; Login to server when programm is starting (False/True)
  172. LoginOnStart=True
  173.  
  174. ; Your status when logging to server
  175. ; Can be Online, Offline, Away, Free_for_char, Occupied, Invisible, NA, DND
  176. Status=Online
  177.  
  178. ; Get information about unknown users automaticaly
  179. AutoGetInfo=True
  180.  
  181. ; Format text when viewing
  182. TextFormat=True
  183.  
  184. ; Check duplicate messages
  185. CheckDuplicates=True
  186.  
  187. ;Sound events available
  188. Sounds=True
  189.  
  190. ; Some sound events
  191. Sound.OnStartup=sounds\start.wav
  192. Sound.OnExit=sounds\exit.wav
  193. Sound.OnConnect=sounds\connect_to_server.wav
  194. Sound.OnReceiveMessage=sounds\message_received.wav
  195. ; This sound will play when you writing message and new message income
  196. Sound.OnReceiveMessageBackground=sounds\message_received_background.wav
  197. ;
  198. Sound.OnSendMessage=sounds\message_sent.wav
  199. Sound.OnNewVersion=sounds\new_version.wav
  200. Sound.OnContactListChange=sounds\contact_list_change.wav
  201. Sound.OnMinimize=sounds\minimize.wav
  202. Sound.OnMaximize=sounds\maximize.wav
  203. Sound.OnUserFound=sounds\user_found.wav
  204. Sound.OnInfoReceived=sounds\info_received.wav
  205.  
  206. ; If you want to use speaker sounds
  207. ;       repeat count       pattern
  208. Sound.OnStartup=@1     100 10 100 4 100 -3 100 4
  209. ; format of this string is (like in T-MAIL):
  210. ; <repeat count> <pattern> <pattern> ...
  211. ; <pattern> - four numbers,
  212. ;  first  - start tone (Hz)
  213. ;  second - tone incriment in a tact
  214. ;  third  - tact length, in msec
  215. ;  fourth - tacts count
  216. ;  so the pattern 100 10 50 4 is sound starting at 100 Hz,
  217. ;  with increment of 10 Hz in a 50 msec will be repeated 4 times.
  218.  
  219. ; Here sounds for users in contact list, when they change status
  220. ; Format is "Sound.On_<User nick, like in contact list>_<Status>=..."
  221. Sound.On_Atlas_Online=sounds\atlas_online.wav
  222.  
  223. ; Timeouts, in seconds
  224. ;
  225. ; When connecting to server
  226. Timeout.Connect=15
  227. ; When searching
  228. Timeout.Search=120
  229. ; When no reply from server
  230. Timeout.ServerFail=60
  231. ; When resending message
  232. Timeout.Resend=120
  233. ; Timeout of sending keep alive message, default 120 sec
  234. Timeout.KeepAlive=120
  235. ; When converting ICQ/Java config
  236. Timeout.ConvertJava=10
  237.  
  238. ; Window size
  239. WindowHeight=44
  240. WindowWidth=110
  241.  
  242. ;Window alignment
  243. ;AlignX may be Right,Left,Center,None
  244. AlignX=Right 
  245. ;AlignY may be Top,Bottom,Center,None
  246. AlignY=Bottom
  247.  
  248. ;Or you can set direct coordinates for left-upper corner of window
  249. WindowX=0
  250. WindowY=0
  251.  
  252. ; Key definition
  253. Key.Online=Alt1
  254. Key.Offline=Alt0
  255.  
  256. ; Use WPS to display status
  257. UseWPS=True
  258.  
  259. ; Show remote users IP address and port
  260. ShowUserIP=false
  261. ; Resolve addresses
  262. ResolveAddr=false
  263.  
  264. ; Icons
  265. ; Format of main icon (that on desktop) definition:
  266. ; Icon.[Status]=<icon file>
  267. Icon.Online=aicq_green.ico
  268. Icon.Offline=aicq.ico
  269.  
  270. ; and for each user:
  271. ;Icon.User.[Name].[Status]=<icon file>
  272. ; or
  273. ;Icon.User.[Name].Message=<icon file> when receive message
  274.  
  275. ;When AICQ is not active
  276. Icon.AICQ=aicq.ico
  277.  
  278. ;Sorting order of old messages
  279. ReverseMessageOrder=false
  280.  
  281. ;Display URL in dialog box
  282. UrlToDialog=true
  283.  
  284. ;WWW Browser (default explore.exe)
  285. WWWBrowser=j:\netscape.4.0\program\netscape.exe
  286.  
  287. ;Show AICQ window when receive message
  288. ShowWindowIfMessage=False
  289.  
  290. ;Use pipe for Sysbar/2
  291. ;This enables writing information (status, message income) into pipe
  292. ;\PIPE\AICQ, so it can be used in SysBar/2's PIPE MONITOR
  293. UsePipe=True
  294.  
  295. ;Colors, do not edit by hands
  296. Colors0=qpxt%20%28%24%17%1F%1A11%1Eq%1F7%3F%3A%13%13%3E%21%3Fp%7Fz%13%13p%7F%7Ep
  297. Colors1=%7Fz%13%13pq%7Ey%20%2B%2Fx%2Ep0%3F%3E%1F%2F%1A%20r110%2F%3E1%138%00%17
  298. Colors2=%1F%1Aqq%1E%17%1F%1E%20%2B%2Fx%2E%100%3F%3Ep%2Fz%20%12110%2F%3E1%138%007
  299. Colors3=%3F%3A%13%13%3E0%3F%3E%20%2B%2Fx%2E0p%7F%7E%1F%2F%1A%2021qp%2F%7Eq%138%00
  300. Colors4=
  301. Colors5=
  302. Colors6=
  303. Colors7=
  304.  
  305. ;Search logging
  306. ;SearchLogging=False
  307.  
  308. ;Convert russian characters from Win1251 codepage to IBM 866 and vice versa.
  309. ;ConvertWin2Ibm=False
  310.  
  311. ;Always ask for automaticaly sended sessage when away,dnd,...
  312. ;AlwaysAskAutoMessage=True
  313.  
  314. Message.Away=I'm away. Call later..
  315. Message.DND=I'm too busy.
  316. Message.NA=I'm not available.
  317. Message.Occupied=Too many work...
  318. Message.Invisible=I'm shadow, I'm does not exist.
  319.  
  320. ;Do not display message when in away,dnd,... 
  321. ;To show message use user's menu (press right mouse button on nickname)
  322. ;HardDND=true
  323.  
  324.  
  325. [User2]
  326. ; and options for another user....
  327.  
  328. -- CUT --
  329.  
  330. Format of contact list and invisible list file:
  331.  
  332. -- CUT --
  333. <username>:<UIN>:<EMail>
  334. -- CUT --
  335.  
  336. Some keys and functions of AICQ
  337. -------------------------------
  338.  
  339. To reconnect to server double click on your current status (works from 001).
  340.  
  341. AICQ will exit with errorlevel 1 when it can't login to server 5 times.
  342.  
  343. Proxy support and configuration
  344. -------------------------------
  345.  
  346. 1.Delegate 
  347.  
  348. The information about "delegate proxy" configuration by 
  349. Sergey Y. Afonin (asy@kraft-s.ru) )
  350.  
  351. cofiguration file:
  352.  
  353. ----icq.cfg----
  354. ADMIN=e-mail@address
  355. AUTH=manager:*:user@host
  356. -P4000/udp
  357. SERVER=udprelay://icq1.mirabilis.com:4000/
  358. -----end-------
  359.  
  360. start with:
  361.  
  362. delegated +=icq.cfg
  363.  
  364. In this case address of icq-server will be address of computer running 
  365. DeleGate, port defined in string -P4000/udp. In example - 4000.
  366.  
  367. The meaning of two last lines is unknown, but it is not work without
  368. them; they are used only if delegate used for http-proxy.
  369.  
  370. -------------------------------------------------------------------------------
  371.  
  372. The author
  373. ----------
  374. Some words about me: my name is Pavel Nikiforov, I'm live in Russia,
  375. in Electrostal (about 60km far from Moscow). Now I'm a student at Moscow
  376. Institute of steel and alloys, and also working in Intellectual Systems Ltd
  377. (www.intsys.ru) as a software developer. My homepage is:
  378. http://atlas.intsys.ru. I write this programm in my free time.
  379.  
  380. You can write me by email: pavel@intsys.ru or 2:5096/6.1@fidonet, or send
  381. message to #13412280.
  382.  
  383. Thanks
  384. ------
  385.  
  386. to Magnus Ihse (d95-mih@nada.kth.se) for documentation,
  387.  
  388. to Sergey Y. Afonin (asy@kraft-s.ru) for testing and features
  389.  
  390. to Don Morse (merlin@blackpalace.com)
  391.  
  392. and to many other people that send me bug reports or wishes.
  393.  
  394. <EOF>
  395.