YSM(1)

NAME
ysm - console ICQ client

SYNOPSIS
ysm

DESCRIPTION
ysm (“You Sick”) is a console ICQ client. It is written in the C language, portable, requires no external libraries, and is available under the GPL license.

YSM is one of the new generation clients due to the sudden modifications the ICQ protocol suffered after Mirabilis joined the dark-side of the force (AOL). This is the reason why most ICQ clients ended up with malfunctions or unable to use the IM network at all.

YSM was (proudly) the first ICQ clone to download and upload server-side contact lists.

The idea behind ysm is to have a portable-quickcompiling console client which lacks of strict library dependencies. The environment around ysm is ment to be fun and comfortable.

NOTICE
For more information on ysm and its usage please refer to the documentation section in ysm's website.

[http://ysmv7.sourceforge.net]

CLIENT COMMANDS

  quit
Close the ysm client.

  help <command>
Query for help on a command

  info
Show information about your ysm client and session.

  clear
Clear the screen.

  readafk
Read the messages stored while you were on afk mode!

  uptime
Check the amount of days, hours, minutes and seconds since you started YSM.

  backdoor
Hehe just a joke :).

  afk
Type 'afk' to switch ON or OFF the Away from Keyboard mode. Excellent, huh?
Type 'afk here_a_message' to set the afk message in runtime.

  last
Show the last received message.

  minimize
Minimize YSM's console window [win32 only]

  tabkey
Special Key. Nick auto-complete. Reply/Resend a message to a slave.
Press <TAB> after you send a message.
Press <TAB> after you receive a message.

  hotkyes
Hotkeys provide you with quick command keys. Press any of the following keys at the start of line:
'1' - help command.
'2' - whos' online (wo)
'3' - list all slaves (w)
'4' - enable/disable AFK (afk)
'5' - read afk messages (readafk)
'6' - current file transfers (fstatus)

  burl
Launch a browser for a specified URL.he browser is configured inside the cfg file.

  run
Run a command in your current shell.
usage : '! ls -al'

  forward [name]
Forward your incoming messages to a specified slave or icq#.

  reconnect
Reconnect to the ICQ Network.

SLAVES/USERS COMMANDS

  slaves
You may check on your Slave list anytime by using this command. The slaves are organized in <slave_name> <status> <flags>. Flags are modified by the 'ignore', 'visible' and 'invisible' commands. Slaves in ignore are only shown in the 'wa' command.

  slaveson
Check your Slaves list just for the online ones. (more help on the 'slaves or w' commands.

  slavesall
You may check on your Slave list anytime by using this command. The slaves are organized in <slave_name> <status> <flags>. Flags are modified by the 'ignore', 'visible' and 'invisible' commands.

  addslave <name> <uin>
Add a slave to your list

  delslave <name>
Delete a slave from list.

  hist <name>
Read a slave's log file (message HISTORY).

  msg <name> [message]
Send a message to a slave or icq.

  mplain <uin1>,<uin2>,.. [message]
Send a textplain message to a slave or icq. (Ignoring any encryption settings).

  chat
Turn ysm into CHAT mode. Just specify the slaves to chat with.
usage: 'chat <slave1>,<slave2>,..
usage: 'ch <slave1>,<slave2>,..'

  lastsent [message]
Send a message to the last slave you messaged.
(Also check the <tab> key function)
usage: 'a [message]'

  reply
Send a message to the last slave who messaged you.
(Also check the <tab> key function)
usage: 'r [message]'

  whois <name>
Request information on a slave or icq#

  search example@email.com
Search icq users by their e-mail.

  save [name]
Upload your slaves to the ICQ servers.

  req [name]
Send an Authorization Request to a slave or icq #.

  auth
Send an authorization OK reply to a slave or icq.
usage: 'auth <name>
usage: 'auth <uin>'

  rename <old_name> <new_name>
Rename a slave.

  ignore <name>
Add/Remove a slave to/from your ignore list.

  visible <name>
Add/Remove a slave to/from your visible list.

  invisible <name>
Add/Remove a slave to/from your invisible list.

  alert <name>
Add/Remove a slave to/from your alert list.

  key
Set an encryption key to use between two YSM clients.
Keys are used to send encrypted messages and encrypted file transfers.
The keys are specified in hexadecimal and they must be max 32 bytes [32 * 2 hex]
In example: 'key rad2k 616161616161616161' sets a 9 bytes long key with rad2k.
You should then tell the slave to set the same key with you.
If used with no arguments, the slave's key will be cleared.
If used with a '?' a 32 bytes random key will be generated, set, and shown in the screen.
In example: 'key rad2k ?'.

  seen <name>
Display signon, last status change andast message received time of a specified slave.

  contacts <dest_slave> <slave1> [slave2] [slave3] ..
Send contacts to a slave or icq #.

  url <dest_slave> <url> [description]
Send a url to a slave or icq #.

  opendc <slave>
Open a DC session to a slave.

  closedc <slave>
Close a DC session to a slave.

  faccept <dest_slave>
Accept a file transfer request from a slave.

  fdecline <dest_slave> [reason]
Decline a file transfer request from a slave.

  send <dest_slave> <filepath> <reason>
Send a file to a slave.

  fstatus
Show the status of active transfers.

  fcancel <slave>
Cancel an ongoing transfer to/from a slave.

ACCOUNT COMMANDS

  info
Show information about your ysm client and session.

  status [new_status]
Change/Check your current status.

  nick [new_nick]
Check/Change your icq nickname.

  email [new@address]
Check/Change your e-mail!.

  password <new_pasword>
Change your ICQ password.

  logall [on|off]
Check/Configure global/specific Logging.

  beep [on|off]
Turn on/off message beeping!

  sounds [on|off]
Turn on/off wave sounds globally.

  loadconfig
Reload configuration file settings.
usage: 'loadconfig'

FILES
$HOME/.ysm/ysm-cfg
    Configuration file.
$HOME/.ysm/afk-log
    Created by the afk-mode.
$HOME/.ysm/uin#
    Each UIN is a log file generated by 'log'.

BUGS
If you come across bugs, report them to : rad2k@mail.ru

AUTHORS
rad2k <rad2k@mail.ru> - author and maintainer of YSM ICQ.

tx - wrote manpage(where are you?).

Franjo Stipanovic <fr1c@aris.ffk.hr> - manpage maintainer.

Other developers as well as people who helped can be found at http://ysmv7.sourceforge.net