GNU/Linux |
CentOS 2.1AS(Slurm) |
|
![]() |
micq(7) |
![]() |
mICQ - interactive commands
This manual page describes the commands that can be used within micq. This page holds the same information as the online help, but more precise and longer.
verbose [verb]
Set verbosity of mICQ to verb, or show the current verbosity. The verbosity level is a set of flags:
8 |
Show protocol errors. |
|||
16 |
Show creation and deletion of packets. |
|||
32 |
Show added and removed queue events. |
|||
64 |
Show created and deleted connections. |
|||
256 |
Show v6 packets and their data. |
|||
4096 |
Show v7/v8 packets. |
|||
8192 |
Show the hexdump of v7/v8 packets. |
|||
16284 |
Save those packets to disc. |
|||
65536 |
Show peer-to-peer packets. |
|||
131072 |
Show the hexdump of peer-to-peer packets. |
|||
262144 |
Save those packets to disc. |
2097152
Show peer-to-peer handshake.
4194304
Show I/O connection setup.
However, any non-zero verbose level will cause more information to be printed, and any level greater than 1 even more.
clear |
Clear the screen. |
sound [on|off|event]
Toggle sound on or off, or call the event script for beeps. New syntax for 0.4.10.
autoaway [timeout|on|off]
Set the timeout to timeout, or switch auto away on using the last used or default auto away time, or switch auto away off saving the current used auto away time. A timeout of 0 is equivalent to off. If no argument is given, the current setting is displayed.
auto [on|off]
Turn auto reply messages on or off. If neither on or off is given the auto reply messages are displayed.
auto status message
Change auto reply message for status status to message.
alias [alias expansion]
Make a new alias named alias which is substituted with expansion. If no arguments are given, all current aliases are listed. If the string %s is present in expansion, it is replaced with the given arguments when the alias is invoked, otherwise they will be appended. New for 0.4.10.
unalias alias
Delete the alias named alias. New for 0.4.10.
alter command new
Make command initially or previously known as command from now on known as new. This command is obsoleted by the alias command as of mICQ 0.4.10.
trans [lang|nr] ...
Switch to the language lang, given by iso code, or output translation string number nr. To select the default language given by the environment variables LANG, LC_ALL and LC_MESSAGES, use !, auto or default. To select no translation at all, use ., none or unload. To get debugging information, prefix it with debug. To get funny messages, postfix it with @fun.
The files from ~/.micq/i18n/*.i18n take precedence over the global ones, while the "funny" ones take precedence over the standard ones.
Actually you may specify as many arguments as you wish, e.g. to print string number 117 in German and then switch back to default language, use "trans de 117 default".
uptime |
Show the time mICQ has been running, plus some statistics. |
set option value
Set option option to
either on or off, or an option specific
set of values. option can be:
hermit:
ignore all non-contacts,
delbs: |
interpret delete characters as backspace, |
|||
funny: |
use funny messages, |
|||
log: |
do logging, |
logonoff:
also log status changes,
auto: |
send auto-replies when you’re e.g. away, |
uinprompt:
have the last nick in the prompt,
autosave:
automatically save the micqrc,
autofinger:
automatically finger new UINs,
linebreak:
set the style for line-breaking messages to simple, to simply print the message after the nick and wrap, break, to add a line break before printing each incoming message, indent, to indent all lines of a message to the level after the nick, or smart, to add a line break only if the message wouldn’t fit on the line;
tabs: |
set the style for tab-handling to simple, to tab through a list of last nick sent to and received from, cycle, to cycle through all online contacts, doing auto-completion, or cycleall, to cycle through all (even offline) contacts, doing auto-completion; |
silent:
suppress some output : off, on, to suppress status changes, or complete, to suppress status changes, logins and logoffs.
New options for 0.4.10.
save |
Saves current settings in the configuration file, which is ~/.micq/micqrc, unless specified otherwise. Beware, it will clobber any comments in this file. | ||
q[uit] |
|||
exit |
Quit mICQ. Aliases quit and exit new for 0.4.10. |
A
<contacts> argument denotes a comma separated
list of contacts, that is, of UINs and nick names. If it is
the last argument, the contacts may also be separated by
spaces.
msg <contacts> [message]
Send a message to all
contacts. Without message multi-line message
mode is enabled. To send the multi-line message, put a
period (.) on a line of its own. To cancel the
message, put a hash sign (#) on a line of its own.
Outgoing and incoming messages are marked differently
depending of the transport used.
««« and
»»» mark messages sent via a direct
connection; if an outgoing message is not acknowledged by
the peer for some time, it is printed marked ===.
«<< and >>» mark icq8
(also called type-2) messages; if an outgoing message is not
acknowledged by the peer for some time, it is printed marked
--=. Lastly, <<< and
>>> mark icq5 messages, which can be so
called type-1, type-4 or offline message. These kind of
messages are not acknowledged.
A message is first tried to be sent via a pre-existing
direct connection; if none is established, one is initiated
in the background for further messages. If no direct
connection is open, or if the message is not acknowledged
after some time, the connection will be failed and the next
transport tried: sending as type-2 message. This step will
be skipped if the peer does not set the required
capabilities to signal its ability to receive them. If this
is skipped, times out or returns an error, e.g. the peer has
gone offline in the time between, the message is sent as an
ordinary type-4 message.
If the peer signals its ability to accept them and support
for them has not been disabled at compile time, messages are
sent UTF-8 encoded and appropriately tagged. Otherwise, the
message is sent encoded in the peer’s configured
encoding, or, if unset, the default assumed remote encoding.
type-1, type-4 and offline messages can not be tagged with
their encoding, so successful transmission of 8bit
characters relies on correct configuration.
a [message]
Send a message to the last person you sent a message to. See msg for more details.
r [message]
Reply to last message received. See msg for more details.
url <contacts> url message
Send a message regarding an url to all contacts.
sms [nick] [cell] message
Send an SMS message message to cell phone number cell, which looks like +<country code><number>, or to the cell phone number of nick, which will be set to cell if unset. You may not specify cell if nick already has a cell phone number given. Invalid cell phone numbers will be removed from the nick’s meta data.
getauto [auto|away|na|dnd|occ|ffc] [contacts]
Requests auto message from contacts for given status, where away is for away, na for not available, dnd for do not disturb, occ for occupied and ffc for free for chat. If auto or nothing is given, the auto message for the contacts is fetched for their respective status. Contacts not in any of those status will be skipped. New for 0.4.10.
auth [req|grant|deny|add] <contacts>
Grant or deny all contacts to add you to their list, request from all contacts to allow you to add them to your contact list, or tell contacts that you added them to your contact list.
resend <contacts>
Resend the last message to more contacts.
last [<contacts>]
Show the last message received from contact, or from everyone who already sent a message.
tabs |
Shows of a list of users you can tab through. This list is only used in the simple tab style. See the tabs option of the set command. |
rand number
Find a random user in interest group number.
s [<contacts>]
Show your current status, or of all given contacts in detail, including all aliases.
e, w, ee, ww, eg, wg, eeg, wwg
List parts of your contact list. The following flags are displayed in the first column:
+ |
This entry is actually no real contact, but an alias of the preceding one. Only with ww. | ||
# |
This entry is not on your contact list, but the UIN was used at some time. Only with w and ww. | ||
* |
This contact will see your status even if you’re invisible. | ||
- |
This contact won’t see you at all. | ||
^ |
This contact is ignored: no messages, no status changes. |
The ww and ee display another column for direct connection flags. If the first column would be empty, it will be displayed in the first contact for all of those commands unless it’s ^.
& |
A direct connection to this contact is established. | ||
| |
A direct connection to this contact has failed. | ||
: |
A direct connection is currently tried to be established. | ||
^ |
No direct connection opened, but IP address and port number are known. | ||
e |
List all people who are online in your contact list.
w |
List all people in your contact list. |
|||
ee |
List all people who are online in your contact list with more details. |
|||
ww |
List all people in your contact list with more details. Also shows all aliases. |
|||
eg |
List all people who are online in your contact list, sorted by contact groups. New for 0.4.10. |
|||
wg |
List all people in your contact list, sorted by contact groups. New for 0.4.10. |
|||
eeg |
List all people who are online in your contact list with more details, sorted by contact groups. New for 0.4.10. |
|||
wwg |
List all people in your contact list with more details. Also shows all aliases, sorted by contact groups. New for 0.4.10. |
|||
ewide |
List all people who are online in your contact list in a screen wide format. |
|||
wide |
List all people who are in your contact list in a screen wide format. |
status [nickname]
Show the status of nickname. This includes IP address, ICQ protocol version and connection type, or list shortly UIN, nick, status and last online time for all contacts.
Note: This command is deprecated, use s or ww instead.
f[inger] uin|nickname
info uin|nickname
Show all white page info for uin|nickname.
i |
List all the people on your ignore list. |
|||
search |
search em@il
search nick
search first last
Search for a user with em@il as their email address, with nick as their nick (which mustn’t contain an @), or with first as their first and last as their last name. If no argument is given, ask for nick name, first name, last name, email address and a whole bunch of other data to search for.
add[group] group [contacts]
Add all contacts in
contacts to the contact group group, which is
created if it doesn’t exist and the command is given
as addgroup. New for 0.4.10.
Note: you need to save to make this persistent.
add[alias] nickname alias
add[alias] uin nickname
Add uin to your contact
list as nickname, or add alias alias for
nickname. New (addalias) for 0.4.10.
Note: you need to save to make this persistent.
rem[group] [all] group
rem[group] group contacts
Remove all contacts in contacts from the contact group group, or remove the contact group completely if all is given. New for 0.4.10. Note: you need to save to make this persistent.
rem[alias] [all] contacts
Remove the aliases in
contacts. If any nick is the last alias for this
contact, or if all is given, remove the contact
completely.
New (remalias) for 0.4.10. Note: you need to save to
make this persistent.
togig contacts
Toggles whether contact’s messages and status changes are ignored.
toginv contacts
Toggles whether you will be hidden for contacts.
togvis contacts
Toggles whether contacts can see you even if you are invisible.
reg password
Creates a new user account with password password.
pass password
Changes your icq password to
password.
Note: your password may not start with ó (the byte
0xf3).
Note: you need to save to make this persistent in
case you save your password in your ~/.micq/micqrc
file (see micqrc(7)), or you will get a mismatched
password on your next login.
change [number [message]]
Changes your status to number. Without a number it lists some available modes. Optionally set auto response for this status to message.
online |
Change status to "online". |
away [message]
Change status to "away". Optionally set auto response for this status to message.
na [message]
Change status to "not available". Optionally set auto response for this status to message.
occ [message]
Change status to "occupied". Optionally set auto response for this status to message.
dnd [message]
Change status to "do not disturb". Optionally set auto response for this status to message.
ffc [message]
Change status to "free for chat". Optionally set auto response for this status to message.
inv |
Change status to "invisible". |
|||
update |
Updates your basic user information (email, nickname, etc.). |
|||
other |
Updates other user information like age and sex. |
|||
about |
Updates your about user information. |
setr [number]
Sets your random user group to number. Without argument, lists possible interest groups.
meta [show|load|save|set|get|rget] <contacts>
Handle meta data of contacts. The following subcommands are known:
show |
Shows the meta data of all contacts given. |
|||
load |
Loads the meta data for all contacts given from disc and shows them. |
|||
save |
Saves the meta data for all contacts given to disc. |
|||
set |
Uploads your meta data to the server. |
|||
get |
Gets the meta data for all contacts from the server and shows them. |
|||
getr |
Gets the meta data for the contact the last message was received from from the server and shows it. |
New for 0.4.10.
file [...]
Alias for peer file. New for 0.4.10.
peer command uin|nick
Operate command command on user given by UIN uin or nick name nick.
open |
Open a peer to peer connection over TCP to the user. |
|||
close |
Close and reset a peer to peer connection to the user. |
|||
off |
Switch off trying to establish such a connection for sending messages until it is explicitly opened or reset. |
file file description
Send file file with description description.
files [file as]... description
Send files to the user. There may be arbitrarily many pairs of a physical file name file and the name to be presented to the peer, as. If as is ’/’, the file name without the path is sent, and if it is ’.’ the same name is sent.
conn [command nr]
List all connections, or operate command on connection nr.
open |
Open the given, or the first server connection. |
|||
login |
Open the given, or the first server connection. |
|||
close |
Close the given connection. Temporary connections will get removed by this. |
|||
remove |
Close and remove given (temporary) connection. |
|||
select |
Select the given server connection as the current one. nr may be the connection number or the UIN used for the connection. |
contact [command]
Handle the server side contact list:
show |
Download the server side contact list and just show it. |
|||
diff |
Download the server side contact list and show only contacts (uin/nick pairs) that are not in the local contact list. |
|||
import |
Download the server side contact list and add all contacts to the local one. |
There is no contact list upload yet.
peek nick
Check whether nick is actually online or not. Abuses a bug in the ICQ protocol to figure this out; no additional information except online or offline can be found out this way.
micq(1), micqrc(5)
This man page was created by James Morrison <ja2morrison@student.math.uwaterloo.ca> for a reference to all interactive commands in mICQ.
![]() |
micq(7) | ![]() |