MICQRC(5)

NAME
~/.micq/micqrc - The configuration file for micq

DESCRIPTION
This manual page describes the configuration file for micq. It consists of several sections that are started by [section], where section is the name of the section.

CONNECTIONS
A Connection section describes a connection within ICQ. Typically, there are two of them, that are related to each other: a connection to the ICQ server, and a connection to listen to peer to peer communication.

type type [auto]
    Set the connection type to type, which can be server for a connection to the ICQ server, or peer for a connection listening to peer to peer communication. If auto is given, create this connection on startup. You presumable want to do this, unless you have several UINs, then set this on the connection corresponding to this UIN you are using.

version nr
    Set the version of the protocol used for this connection to nr. Please note that for server connections, only version 5 is supported, though 8 is planned, and for peer to peer connections only 6.

server server
    Set the server to connect to to server. This defaults to icq.icq.com. Unused for peer to peer connections.

port port
    Set the port to connect on the server to port, or the port to listen on for peer to peer connections to port.

uin UIN
    Set the UIN to log in with to UIN. Unused for peer to peer connections.

password [password]
    Se the password to log in with to password. Unused for peer to peer connections. If omitted, ask for password on startup.

status nr
    Set the status to be on log in in to nr. Status can be:
    0 Online
    1 Away
    5 Not Available
    17 Occupied
    19 Do Not disturb
    32 Free for Chat
    256 Invisible

GENERAL
This section includes the options for SOCKS 5, that may be eventually moved to their own section, general options, and some strings to override.

s5_use number
    Set number to 0 to disable and 1 to enable.

s5_host host
    Connect to socks 5 proxy on host host.

s5_port port
    Connect to socks 5 proxy listening on port port.

s5_auth number
    Set number to 0 to omit authentification and 1 to do authentification.

s5_name name
    Identify as user name to socks 5 proxy.

s5_pass password
    Authenticate with password password to socks 5 proxy.

Now the options:

verbose level
    Set the verbosity level on startup to level.

auto_away time
    Set the time to set status to away after to time seconds. Set to 0 to disable.

Screen_width width
    Set the default screen with to width. If unset or 0, 80 will be used. This is rarely needed as usually the current screen width can be deduced on runtime.

set delbs on|off
    If set to on, let the delete character act as a backspace. When off, let it act as a delete character.

set russian on|off
    Disable or enable Russian character conversion between koi8-r/u and cp1251.

set japanese on|off
    Disable or enable Japanese character conversion between Shift-JIS and EUC.

set funny on|off
    Disable or enable "funny" messages.

set color on|off
    Disable or enable the use of colors.

set hermit on|off
    If set to on, ignore all messages from everyone not on your contact list.

set log on|off
    Disable or enable logging.

set logonoff on|off
    Whenn logging, disable or enable the logging of online/offline status changes.

set auto on|off
    Disable or enable automatic responses (reply messages).

set uinprompt on|off
    Disable or enable the use of the nick you last received a message from in the prompt.

set linebreak type
    The the line break type for incoming messages to type, which can be simple to just wrap lines as usual, break to have a line break before each message, indent to have a line break and indent the message and smart to have a line break only if the message doesn't fit on the current line.

At last, some strings can be defined:

logplace file|dir
    Set the file to log into to file, or the directory to log into to dir. Please note that a path is assumed to be a directory if it has a trailing /.

sound on|off|cmd
    Disable or enable beeping. If the argument is neither on nor off, it is assumed to be a program to execute instead of beeping.

soundonline on|off|cmd
    The same as above for users coming online.

soundoffline on|off|cmd
    The same as above for users going offline.

receivescript cmd
    The command to execute for incoming messages. Leave blank to do nothing.

auto status string
    Set the automatic reply in status status to string. This option may be repeated for all possible values away, na, dnd, occ, and inv for status.

STRINGS
This sections contains command renames.

alter old new
    Rename command old to new. Note the old name may still be used, unless it conflicts with some new name. For posible command names, see micq(7). This option may be repeated as desired.

CONTACTS
This section contains the contact list.

[*] [~] uin nick
    Make user with UIN uin known under the nick nick. If * is given, the user may see you while you're invisible. If ~ is given, ignore this user and let him see you as always offline.
Note: the contact list has to be the last part of this file.

SEE ALSO
micq(1), micq(7)

Author
This man page was written by James Morrison <ja2morrison@student.math.uwaterloo.ca>. It was rewritten to match new config file syntax by Rüdiger Kuhlmann <micq@ruediger-kuhlmann.de>.