1CLIMM(7) Miscellaneous Information Manual CLIMM(7)
2
6 climm - interactive commands
7
9 This manual page describes the commands that can be used within climm.
10 This page holds the same information as the online help, but more pre‐
11 cise and longer. Notations: square brackets ([]) denote optional argu‐
12 ments, while angle brackets (<>) denote arguments (in opposite to key‐
13 words). Specifically, <uin> denotes an arbitrary UIN, while <contacts>
14 denotes a comma separated list of contacts, that is, of UINs and nick
15 names. If it is the last argument, the contacts may also be separated
16 by spaces.
17
19 msg <contacts> [<message>]
20 Send a message to all contacts. Without message, or with mes‐
21 sage ending in a backslash (\), multi-line message mode is
22 enabled. To send the multi-line message, put a period (.) on a
23 line of its own. To cancel the message, put a hash sign (#) on
24 a line of its own.
25 Outgoing and incoming messages are marked differently depending
26 of the transport used. ««« and »»» mark messages sent via a
27 direct connection. «%« and »%» mark messages sent via a direct
28 connection that were encrypted (requires GnuTLS or OpenSSL
29 enabled at compile time). «<< and >>» mark icq8 (also called
30 type-2) messages. Lastly, <<< and >>> mark icq5 messages, which
31 can be so called type-1, type-4 or offline message. These kind
32 of messages are not acknowledged.
33 A message is first tried to be sent via a pre-existing direct
34 connection; if none is established, one is initiated in the
35 background for further messages. If no direct connection is
36 open, or if the message is not acknowledged after some time, the
37 connection will be failed and the next transport tried: sending
38 as type-2 message. This step will be skipped if the peer does
39 not set the required capabilities to signal its ability to
40 receive them. If this is skipped, times out or returns an error,
41 e.g. the peer has gone offline in the time between, the message
42 is sent as an ordinary type-4 message.
43 If the peer signals its ability to accept them, messages are
44 sent UTF-8 encoded and appropriately tagged. Otherwise, the mes‐
45 sage is sent encoded in the peer´s configured encoding, or, if
46 unset, the default assumed remote encoding. type-1, type-4 and
47 offline messages can not be tagged with their encoding, so suc‐
48 cessful transmission of non-USASCII-characters relies on correct
49 configuration and heuristics.
50 a [<message>]
52 Send a message to the last person you sent a message to. Auto-
53 expanding alias for msg %a.
54 r [<message>]
56 Reply to last message received. Auto-expanding alias for
57 msg %r.
58 url <contacts> <url> <message>
60 Send a message regarding an url to all contacts.
61 sms [<nick>] [<cell>] <message>
63 Send an SMS message message to cell phone number cell, which
64 looks like +<country code><number>, or to the cell phone number
65 of nick, which will be set to cell if unset. You may not specify
66 cell if nick already has a cell phone number given. Invalid cell
67 phone numbers will be removed from the nick´s meta data.
68 chat <contacts> [<message>]
70 Sends a message message to contacts contacts just as the msg
71 command. After the message is sent (or cancelled), multi-line
72 mode is entered and messages sent until an empty message is can‐
73 celled. Cancelling a non-empty message will only cancel the
74 message itself, and more messages in multi-line mode can be
75 sent.
76 getauto [auto|away|na|dnd|occ|ffc] [<contacts>]
78 Requests auto message from contacts for given status, where away
79 is for away, na for not available, dnd for do not disturb, occ
80 for occupied and ffc for free for chat. If auto or nothing is
81 given, the auto message for the contacts is fetched for their
82 respective status. Contacts not in any of those status will be
83 skipped. New for 0.4.10.
84 auth [req|grant|deny|unsub|add] <contacts> [<msg>]
86 Grant or deny all contacts to add you to their list, request
87 from all contacts to allow you to add them to your contact list,
88 unsubscribe from contacts status notifications (XMPP, not ICQ),
89 or tell contacts that you added them to your contact list (ICQ,
90 not XMPP). For ICQ, an optional message may accompany some
91 requests. New subcommand unsub for 0.7.1.
92 resend <contacts>
94 Resend the last message to more contacts.
95 last [<contacts>]
97 Show the last message received from contact, or from everyone
98 who already sent a message.
99 h <contact> [<last> [<count>]]
101 history <contact> [<last> [<count>]]
103 Show messages from <contact> from the log files. Start at the
104 last latest message, or the -last message if last is negative,
105 defaulting to the 20ieth last message, and display count mes‐
106 sages, defaulting to 20 if not given.
107 historyd <contact|*> <date> [<count>]
109 Show messages from <contact> or all contacts (for *) from the
110 log files. Start at date date, which must be given in ISO 8601
111 format, either YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS, and display
112 count messages, defaulting to 20 if not given.
113 find <contact> <pattern>
115 Search the pattern pattern case-insensitive in the log file for
116 contact.
117 finds <contact> <pattern>
119 Search the pattern pattern case-sensitive in the log file for
120 contact.
121 tabs Shows of a list of users you can tab through.
123
125 login A built-in shortcut for conn login. Opens the first server con‐
126 nection.
127 online [for <contacts>] [<message>]
129 Change status to online, or change status to online only for the
130 listed contacts and optionally specify the status message for
131 them.
132 away [for <contacts>] [<message>]
134 Change status to away and optionally set status message and auto
135 response temporarely for this status to message, or change sta‐
136 tus only for given contacts and optionally specify the status
137 message for them.
138 na [for <contacts>] [<message>]
140 Change status to na (not available) and optionally set status
141 message and auto response temporarely for this status to mes‐
142 sage, or change status only for given contacts and optionally
143 specify the status message for them.
144 occ [for <contacts>] [<message>]
146 Change status to occ (occupied) and optionally set status mes‐
147 sage and auto response temporarely for this status to message,
148 or change status only for given contacts and optionally specify
149 the status message for them.
150 dnd [for <contacts>] [<message>]
152 Change status to dnd (do not disturb) and optionally set status
153 message and auto response temporarely for this status to mes‐
154 sage, or change status only for given contacts and optionally
155 specify the status message for them.
156 ffc [for <contacts>] [<message>]
158 Change status to ffc (free for chat) and optionally set auto
159 response temporarely for this status to message, or change sta‐
160 tus only for given contacts and optionally specify the status
161 message for them.
162 inv [for <contacts>] [<message>]
164 Change status to inv (invisible) and optionally set auto
165 response temporarely for this status to message, or change sta‐
166 tus only for given contacts and optionally specify the status
167 message for them.
168 change [<number> [for <contacts>] [<message>]]
170 Without a number it lists some available modes. Otherwise,
171 change status to number and optionally set auto response tempo‐
172 rarely for this status to message, or change status only for
173 given contacts and optionally specify the status message for
174 them.
175
177 f <contacts>
178 finger <contacts>
180 Show all white page information for contacts <contacts>.
181 ss <contacts>
183 Show all saved white page information for contacts <contacts>.
184 i List all the people on your ignore list.
186 s [<contacts>]
188 Show your current status, or of all given contacts in detail,
189 including all aliases.
190 e, ee, eg, eeg, ev, eev, egv, eegv, w, ww, wg, wwg, wv, wwv, wgv, wwgv
192 List parts of your contact list. The following flags are dis‐
193 played in the first column:
194 + This entry is actually no real contact, but an alias of
196 the preceding one. Only with ww.
197 # This entry is not on your contact list, but the UIN was
199 used at some time. Only with w and ww.
200 * This contact will see your status even if you´re invisi‐
202 ble.
203 - This contact won´t see you at all.
205 ^ This contact is ignored: no messages, no status changes.
207 The ww* and ee* group of commands display another column for
209 direct connection flags. If the first column would be empty, it
210 will be displayed in the first contact for all of those commands
211 unless it´s ^.
212 & A direct connection to this contact is established.
214 | A direct connection to this contact has failed.
216 : A direct connection is currently tried to be established.
218 ^ No direct connection opened, but IP address and port num‐
220 ber are known.
221 Another column is added for the ww* and ee* group of commands to
223 show the status with regards to the server side contact list, as
224 far as it is known (new flags for 0.7.1):
225 S The contact is in the server side contact list with
227 mutual authorization, and should be there (has the
228 wantsbl flag set).
229 T The contact is in the server side contact list with
231 mutual non-authorization, awaited authorization from, and
232 should be there.
233 . The contact is not in the server side contact list, but
235 should be there.
236 R The contact is in the server side contact list receiving
238 presence reports, awaited authorization from, and should
239 be there. You may eventually want to re-request or deny
240 authorization to archieve mutuality. This combination is
241 possible only for XMPP.
242 > The contact is in the server side contact list receiving
244 presence reports, not awaited authorization from, and
245 should be there. You may want to request or deny autho‐
246 rization to archieve mutuality. This combination is pos‐
247 sible only for XMPP.
248 < The contact is in the server side contact list sending
250 presence reports, not awaited authorization from, and
251 should be there. This combination is possible only for
252 XMPP.
253 - The contact is in the server side contact list with
255 mutual non-authorization, not awaited authorization from,
256 and should be there. This combination is possible only
257 for XMPP.
258 s The contact is in the server side contact list with
260 mutual authorization, but should not be there (does not
261 have the wantsbl flag set).
262 t The contact is in the server side contact list with
264 mutual non-authorization, awaited authorization from, but
265 should not be there.
266 ´ ´ (space) The contact is not in the server side contact
268 list, and is not wanted there.
269 \ The contact is in the server side contact list receiving
271 presence reports, not awaited authorization from, but
272 should not be there. You may want to request or deny
273 authorization to archieve mutuality. This combination is
274 possible only for XMPP.
275 / The contact is in the server side contact list sending
277 presence reports, not awaited authorization from, but
278 should not be there. This combination is possible only
279 for XMPP.
280 ' The contact is in the server side contact list with
282 mutual non-authorization, not awaited authorization from,
283 but should not be there. This combination is possible
284 only for XMPP.
285 1 2 3 4 5 6 7 8 9
287 An impossible combination was encountered.
288 e [<group>]
290 List all people which are online in your contact list. Also
291 print your own status.
292 ee [<group>]
294 List all people which are online in your contact list with more
295 details.
296 eg, eeg
298 As above, but sort by groups. New for 0.4.10.
299 w, ww, wg, wwg
301 As above, but also include offline contacts.
302 ev, eev, egv, eegv, wv, wwv, wgv, wwgv
304 As above, but also include hidden contacts (with the shadow
305 option effectively set). New for 0.5.
306 ewide List all people which are online in your contact list in a
308 screen wide format.
309 wide List all people in your contact list in a screen wide format.
311 search
313 search <em@il>
315 search <contact>
317 search <first> <last>
319 Search for a user with em@il as their email address, with nick
320 as their nick (which mustn´t contain an @), or with first as
321 their first and last as their last name. If no argument is
322 given, ask for nick name, first name, last name, email address
323 and a whole bunch of other data to search for.
324 rand [<number>]
326 Find a random user in interest group number. If number is not
327 given, list all interest groups.
328
330 Note: you need to save to make any of the changes done by these comm‐
331 mands persistent for the local contact list.
332 add <uin> <nickname>
334 Add uin to your contact list as nickname.
335 add <contact> <alias>
337 addalias <contact> <alias>
339 Add alias alias for nickname. New (addalias) for 0.4.10.
340 add [<group> [<contacts>]
342 addgroup <group> [<contacts>]
344 Add all contacts in contacts to the contact group group, which
345 is created if it doesn´t exist and the command is given as
346 addgroup. New for 0.4.10.
347 rem <contacts>
349 Remove the aliases in contacts. If any nick is the last alias
350 for this contact, remove the contact completely.
351 Note: This command has a different meaning if the first argument
352 of the contacts is a group name, so if you want to affect all
353 contacts of a group, you may not use this as the first parame‐
354 ter; e.g. mention one member of the group first.
355 remalias <contacts>
357 Remove the aliases in contacts.
358 Modified for 0.6.3.
359 rem all <contacts>
361 remcont <contacts>
363 Remove the contact completely from the contact list.
364 New (remcont) for 0.6.3.
365 Note: The command rem has a different meaning if the first argu‐
366 ment of the contacts is a group name, so if you want to affect
367 all contacts of a group, you may not use this as the first
368 parameter; e.g. mention one member of the group first.
369 rem <group> <contacts>
371 remgroup <group> <contacts>
373 Remove all contacts in contacts from the contact group group.
374 Modified for 0.6.3.
375 rem all <group>
377 remgroup all <group>
379 Remove all contacts from the contact group group. Further argu‐
380 ments may be silently ignored. If remgroup all is used, discard
381 of the contact group completely. Modified for 0.6.3.
382 togig <contacts>
384 Toggles whether contact´s messages and status changes are
385 ignored.
386 toginv <contacts>
388 Toggles whether you will be hidden for contacts.
389 togvis <contacts>
391 Toggles whether contacts can see you even if you are invisible.
392
394 pass <password>
395 Changes your icq password to password.
396 Note: your password may not start with ó (the byte 0xf3).
397 Note: you need to save to make this persistent in case you save
398 your password in your ~/.climm/climmrc file (see climmrc(5)), or
399 you will get a mismatched password on your next login.
400 update Updates your basic user information (email, nickname, etc.).
402 other Updates other user information like age and sex.
404 about Updates your about user information.
406 setr [<number>]
408 Sets your random user group to number. Without argument, lists
409 possible interest groups.
410 reg <password>
412 Creates a new user account with password password.
413
415 verbose [<level>]
416 Set verbosity of climm to level, or show the current verbosity.
417 The verbosity level is a set of flags:
418 8 Show protocol errors.
420 16 Show creation and deletion of packets.
422 32 Show added and removed queue events.
424 64 Show created and deleted connections.
426 256 Show v6 packets and their data.
428 4096 Show v7/v8 packets.
430 8192 Show the hexdump of v7/v8 packets.
432 16284 Save those packets to disc.
434 65536 Show peer-to-peer packets.
436 131072 Show the hexdump of peer-to-peer packets.
438 262144 Save those packets to disc.
440 2097152
442 Show peer-to-peer handshake.
443 4194304
445 Show I/O connection setup.
446 However, any non-zero verbose level will cause more information
448 to be printed, and any level greater than 1 even more.
449 clear Clear the screen.
451 sound [on|off|event]
453 Toggle sound on or off, or call the event script for beeps. New
454 syntax for 0.4.10.
455 prompt <user_prompt>
457 Set user prompt in user_prompt. The following variables will be
458 parsed and may be used in prompt string:
459 %U by your current user name
461 %n by your current nick
463 %S by description of your status
465 %s by short description of your status
467 %P by server name
469 %p by type of server (icq8, jabber, msn...)
471 %a by last send uin/nick
473 %r by last recived uin/nick
475 %t by time in format HH:MM:SS
477 %T by time in format given in option prompt_strftime .
479 %% %
481 %[0-9]c
483 by foreground color
484 %[0-9]C
486 by background color
487 %[0-1]b
489 bold. on = 1 (default), off = 0
490 %[0-1]u
492 underline. on = 1 (default), off = 0
493 %[0-1]i
495 inverse; on = 1 (default), off = 0. Reverses foreground
496 and background colors.
497 %d set default all colors and styles
499 \b backspace
501 \r carriage return
503 \n new line
505 \t horizontal tab
507 \e ESC
509 \\ backslash
511 Example:
513 prompt %4c%b%p%d://%1c%b%n%3c/%2c%b%s%8c
514 %t%7c%b>%6c%r%7c%b<%6c%b%a%7c%b>
515 autoaway [<timeout>|on|off]
517 Set the timeout to timeout, or switch auto away on using the
518 last used or default auto away time, or switch auto away off
519 saving the current used auto away time. A timeout of 0 is equiv‐
520 alent to off. If no argument is given, the current setting is
521 displayed.
522 alias [auto[expand]] [<alias> [<expansion>]]
524 Make a new alias named alias which is substituted with expan‐
525 sion. If no alias is given, list all current aliases. If no
526 expansion is given, list the current alias. Otherwise, create a
527 new alias. If the auto or autoexpand keyword is given, the new
528 alias is auto-expanding, that is, it is immediately expanded
529 when the space or return key is pressed directly after entering
530 the alias.
531 If the string %s is present in expansion, each occurence is
532 replaced with the given arguments when the alias is invoked,
533 otherwise they will be appended. If the string %r is present in
534 expansion, each occurence is replaced by the nick name or, if
535 the nick is not available, the UIN, of the contact that sent the
536 last message to you, or the empty string if there is none. If
537 the string %a is present in expansion, each occurence is
538 replaced by the nick name or, if the nick is not available, the
539 UIN, of the contact that you sent the last message to, or the
540 empty string if there is none.
541 New for 0.4.10. Auto-expanding aliases new for 0.5.0.4.
542 unalias <alias>
544 Delete the alias named alias. New for 0.4.10.
545 lang [<lang>|<nr>] ...
547 Switch to the language and encoding lang, given by iso code, or
548 output translation string number nr. To select the default lan‐
549 guage given by the environment variables LANG, LC_ALL and
550 LC_MESSAGES, use !, auto or default. To select no translation
551 at all, use ., none or unload. To get debugging information,
552 prefix it with debug.
553 The files from ~/.climm/i18n/*.i18n take precedence over the
555 global ones, the files from BASE/i18n/*.i18b take precedence
556 over those from ~/.climm/i18n/*.i18n, while the "funny" texts
557 take precedence over the standard ones.
558 You may specify as many arguments as you wish, e.g. to print
560 string number 117 in German and then switch back to default lan‐
561 guage, use "trans de 117 default".
562 uptime Show the time climm has been running, plus some statistics.
564 set <option> <value>
566 Set option option to either on or off, or an option specific set
567 of values. option can be:
568 color: use colors,
570 delbs: interpret delete characters as backspace,
572 funny: use funny messages,
574 auto: send auto-replies when you´re e.g. away,
576 prompt:
578 Type of the prompt:
579 user use user prompt. See command prompt in climm‐
581 cmds(7), and options prompt and prompt_strftime in
582 climmrc(5),
583 uin have the last nick in the prompt,
585 simple simple prompt, by default is "climm>".
587 autosave:
589 automatically save the climmrc,
590 autofinger:
592 automatically finger new UINs,
593 linebreak:
595 set the style for line-breaking messages to simple, to
596 simply print the message after the nick and wrap, break,
597 to add a line break before printing each incoming mes‐
598 sage, indent, to indent all lines of a message to the
599 level after the nick, or smart, to add a line break only
600 if the message wouldn´t fit on the line.
601 New options for 0.4.10. Options hermit, log, logonoff, silent,
603 tabs removed for 0.5; use the opt command for them.
604 opt [<contact>|<contact group>|connection|global [<option> [<value>]]]
606 Set option option for contact contact, contact group con‐
607 tact group, for the current connection or globally to the value
608 value, or display the current value, or display all options and
609 their settings.
610 When resolving options for contacts, the option for the contact
611 itself will be used, if set; otherwise, if the contact belongs
612 to a group, the option for that group, if set; otherwise, if the
613 contact belongs to a server connection (i.e. is not yet
614 removed), the option for the server connection; otherwise the
615 global option, if set. Otherwise, 0 for integer options, FALSE
616 for boolean options, the color string for "no color" unless this
617 color string is requested, or the empty string for string
618 options.
619 When resolving options for contact groups, the same is done
620 except for the first step; options for connections are taken
621 from the connection, then globally; and global options, of
622 course, only globally.
623 The following options currently exist, with type and applicabil‐
624 ity:
625 colorscheme integer global
627 The number of the color scheme to use. Set to 0 to dis‐
628 able and use the colors defined below.
629 colornone color global
631 The color string to use for normal text. The keywords
632 black, red, green, yellow, blue, magenta, cyan, white,
633 none, and bold are understood and replaced by their ANSI
634 control sequences. Note that any color already includes
635 none, so specify bold always after the color. Any other
636 text is interpreted as control characters to output ver‐
637 batim.
638 colorserver color global
640 The color string to use for server stuff.
641 colorclient color global
643 The color string to use for client stuff.
644 colorinvchar color global
646 The color string to use when displaying byte-sequences
647 invalid for the given encoding.
648 colorerror color global
650 The color string to use for errors.
651 colordebug color global
653 The color string to use for debug output.
654 colorquote color global
656 The color string to use for quoted text.
657 scripting boolean global
659 Open a scripting FIFO to accept commands as if entered
660 through the command line.
661 scriptingpath string global
663 The FIFO to open for those commands. If not set and
664 scripting is on, BASDIR/scripting will be used.
665 webaware boolean server[ICQ]
667 Whether the current status should be visible on the web
668 site.
669 hideip boolean server[ICQ]
671 Whether to hide the (local) IP address towards other
672 users.
673 dcauth boolean server[ICQ]
675 Whether authorized contacts can see the (remote) IP
676 address.
677 dccont boolean server[ICQ]
679 Whether contacts can see the (remote) IP address.
680 awaycount boolean server
682 If set, incoming messages will be counted and their orig‐
683 inators shown if the status is manually changed to any‐
684 thing other than online or ffc (with or without invisi‐
685 ble). Otherwise, this is only done if the status was
686 automatically changed to away or na (with or without
687 invisible).
688 s5_use boolean server
690 Enable the use of a socks 5 proxy. New for 0.6.4.
691 s5_host string server
693 Connect to socks 5 proxy on the given host. New for
694 0.6.4.
695 s5_port integer server
697 Connect to socks 5 proxy listening on the given port num‐
698 ber. New for 0.6.4.
699 s5_name string server
701 Identify as the given user to the socks 5 proxy. New for
702 0.6.4.
703 s5_pass string server
705 Authenticate with the given password to the socks 5
706 proxy. New for 0.6.4.
707 oscar_dc_port integer server[ICQ]
709 Define the minimum port to listen for incoming direct
710 connections when using the oscar protocol. If the given
711 port is in used, the port number actually used is
712 increased until a free one is found. New for 0.6.4.
713 oscar_dc_mode integer server[ICQ]
715 This integer is for flags how to handle direct connec‐
716 tions:
717 1 We´re firewalled and can´t receive any connection.
719 Don´t even try.
720 2 We´re firewalled, but use SOCKS and can receive
722 connections.
723 4 We´re not firewalled at all. This is the default.
725 16 Actually create a peer to peer connection. (Pre‐
727 cisely, the connection is created if mode >= 16.)
728 If the connection is not configured to be opened
729 directly, it will be opened when it is needed.
730 32 Create and open a peer to peer connection.
732 New for 0.6.3.
733 logstream boolean server
735 Log all data sent over the connection to the server into
736 a file in BASEDIR/debug/.
737 privacylist string server[XMPP]
739 After login, select the given privacy list as the active
740 list for this session. If the list is empty, select no
741 privacy list as active. Otherwise, the default privacy
742 list will be the active one.
743 New for 0.7.1.
744 ignore boolean contact
746 Whether to ignore all messages from this contact.
747 hidefrom boolean contact
749 Whether to be invisible for this contact.
750 intimate boolean contact
752 Whether to be always visible for this contact.
753 logonoff boolean contact
755 Whether to log when this contacts goes online or offline.
756 logchange boolean contact
758 Whether to log status changes for this contact.
759 logmess boolean contact
761 Whether to log messages for this contact.
762 showonoff boolean contact
764 Whether to show when this contact goes online or offline.
765 showchange boolean contact
767 Whether to show status changes for this contact.
768 autoauto boolean contact
770 Whether to automatically request automatic messages on status
771 changes for this contact.
772 hideack boolean contact
774 Whether to hide acknowledges for messages to this contact.
775 Note: using this is a really bad idea, as you'll miss when mes‐
776 sages are resent without acknowledge.
777 wantsbl boolean contact
779 Whether you want this contact to be on the server side contact
780 list.
781 peekme boolean contact
783 Whether you want this contact to be peeked when using the
784 peek all or peekall command.
785 shadow boolean contact
787 Whether you want to hide this contact in contact list displays
788 as long as none of the *v commands is used.
789 local boolean contact
791 Whether this contact is not a real contact, but just a nick for
792 a number.
793 encoding string contact
795 The encoding to assume for messages whose encoding is undefined,
796 in particular meta data on the server.
797 tabspool integer contact
799 Whether to add a contact to the tabs list upon startup.
800 revealtime integer contact
802 The time in seconds one's presence is revealed (even despite
803 invisibility) towards the peer if a message is sent to him.
804 autoaway string contact
806 The autoaway string for status away to return to this contact.
807 autona string contact
809 The autoaway string for status na to return to this contact.
810 autoocc string contact
812 The autoaway string for status occ to return to this contact.
813 autodnd string contact
815 The autoaway string for status dnd to return to this contact.
816 autoffc string contact
818 The autoaway string for status ffc to return to this contact.
819 colormessage string contact
821 The color string to use for messages of this contact.
822 colorsent string contact
824 The color string to use for the nick when messages are sent.
825 colorack string contact
827 The color string to use for the nick when messages are acknowl‐
828 edged.
829 colorincoming string contact
831 The color string to use for the nick when messages are received.
832 colorcontact string contact
834 The color string to use for the nick otherwise.
835 New for 0.5.
837 optcontact <contact> [<option> [<value>]]
839 Set or display option option or all options of contact contact.
840 New for 0.5.
841 optgroup <group> [<option> [<value>]]
843 Set or display option option or all options of contact group
844 group. New for 0.5.
845 optserv [<option> [<value>]]
847 Set or display server option option. Renamed for 0.7.1, old
848 name new in 0.5.
849 optglobal [<option> [<value>]]
851 Set or display global option option. New for 0.5.
852 save Saves current settings in the configuration file, which is
854 ~/.climm/climmrc, unless specified otherwise. Beware, it will
855 clobber any comments in this file.
856 q [<msg>]
858 quit [<msg>]
860 exit [<msg>]
862 Quit climm. If given, send the message msg to all contacts pre‐
863 viously messaged that are still online and on the contact list.
864 Note: climm will not wait for any acknowledges - if the message
865 is not received by the contact for whatever reason, it will not
866 be resent.
867 Aliases quit and exit new for 0.4.10.
868 x [<msg>]
870 Quit climm without saving. If given, send the message msg to all
871 contacts previously messaged that are still online and on the
872 contact list.
873 Note: climm will not wait for any acknowledges - if the message
874 is not received by the contact for whatever reason, it will not
875 be resent.
876 Aliases quit and exit new for 0.4.10. New for 0.5.
877
879 meta [show|load|save|set|get|rget] <contacts>
880 Handle meta data of contacts. The following subcommands are
881 known:
882 show Shows the meta data of all contacts given.
884 load Loads the meta data for all contacts given from disc and
886 shows them.
887 save Saves the meta data for all contacts given to disc.
889 set Uploads your meta data to the server.
891 get Gets the meta data for all contacts from the server and
893 shows them.
894 getr Gets the meta data for the contact the last message was
896 received from from the server and shows it.
897 New for 0.4.10.
899 file [...]
901 Alias for peer file. New for 0.4.10.
902 accept [...]
904 Alias for peer accept. New for 0.4.10.4.
905 peer <command> <uin|nick>
907 Operate command command on user given by UIN uin or nick name
908 nick.
909 open Open a peer to peer connection over TCP to the user.
911 close Close and reset a peer to peer connection to the user.
913 off Switch off trying to establish such a connection for
915 sending messages until it is explicitly opened or reset.
916 file <file> <description>
918 Send file file with description description.
919 files [<file> <as>]... <description>
921 Send files to the user. There may be arbitrarily many
922 pairs of a physical file name file and the name to be
923 presented to the peer, as. If as is ´/´, the file name
924 without the path is sent, and if it is ´.´ the same name
925 is sent.
926 accept [<contact>] [<id>]
928 Accept an incoming file request from contact with the
929 given ID id. If there is only one pending incoming file
930 request, the contact and id arguments may be omitted,
931 otherwise it is undefined which file request is answered
932 when several match.
933 deny [<contact>] [<id>] [<reason>]
935 Deny an incoming file request from contact with the given
936 ID id with the reason reason.
937 login [...]
939 Alias for conn login. New for 0.4.10.4.
940 conn [<command> <nr>]
942 List all connections, or operate command on connection nr.
943 open Open the given, or the first server connection. An
945 optional password may be given, which overrides any pre‐
946 viously known one.
947 login Open the given, or the first server connection. An
949 optional password may be given, which overrides any pre‐
950 viously known one.
951 close Close the given connection. Temporary connections will
953 get removed by this.
954 remove Close and remove given (temporary) connection.
956 select Select the given server connection as the current one.
958 nr may be the connection number or the UIN used for the
959 connection.
960 contact [<command>]
962 Handle the server side contact list:
963 show Download the server side contact list and just show it.
965 diff Download the server side contact list and show only con‐
967 tacts (uin/nick pairs) that are not in the local contact
968 list.
969 add Download the server side contact list and add all con‐
971 tacts to the local one.
972 upload Try to upload local contacts to the server side contact
974 list.
975 download
977 Download contacts from the server side contact list, but
978 avoid modifying already existing contacts.
979 import Download contacts from the server side contact list, mod‐
981 ifying existing contacts.
982 Note: This will always try to upload only those contacts
983 with the wantsbl contact option. Do a optglobal wantsbl
984 on if you want to upload all of your contacts.
985 priv [<cmd>] [<list>] [<edits>]
987 Show or modify XMPP privacy lists. If no argument is given,
988 assume list command, otherwise assume show command. Available
989 commands are:
990 list List the active, default and all available privacy lists
992 by name.
993 active [<list>]
995 Make <list> the privacy list currently active for this
996 session. If no <list> is given, disable active list, in
997 other words: use the server's default privacy handling
998 for this session.
999 default [<list>]
1001 Make <list> the default privacy list, that is, the pri‐
1002 vacy list valid at start of each client's session or when
1003 no client is actually connected. If no <list> is given,
1004 disable default list, in other words: use the server's
1005 default privacy handling at session start or when no
1006 client is actually connected.
1007 show <list>
1009 Show the given privacy list, for each item in it print
1010 out the order, the action (allow or deny), the affected
1011 part (all, or a comma separated list of msg (messages),
1012 pin (inbound presense notification, does not include sub‐
1013 scription requests), pout (outbound presense notifica‐
1014 tions), or iq (queries)), the type (jid, group, or sub‐
1015 scription), and the matched value. If type is jid, the
1016 value is an XMPP id; it may be with or without resource,
1017 and with or without user. If type is subscription, the
1018 value will be one of both, from, to, or none (which also
1019 includes unknown contacts).
1020 Each inbound or outbound stanza is matched by the server
1021 against each item, in the order given by the order
1022 attribute, and the action attribute of the first match
1023 determines whether the stanza is completely discarded or
1024 actually forwarded.
1025 set <list> (<action> [<part> ]<type> <value)...
1027 Replace (or create) the privacy list <list>, with each of
1028 the listed items in ascending order. The parameters are
1029 as in the show command above. If <part> is not given, all
1030 is assumed.
1031 edit <list> <index> (<action> [<part>] <type> <value>)... [delete <skip>]
1033 Edit (or create) the privacy list <list>, inserting the
1034 given listed items in ascending order directly before the
1035 item with the <order> being equal to <index>. Delete
1036 items up to (excluding) <order> of <index>+<skip>. If no
1037 <skip> is given or if it is zero, none will be deleted.
1038 Items with <order> being equal or greater than
1039 <index>+<skip> will be renumbered (to make room for the
1040 new items and to avoid discontinuency in the numbers).
1041 peek [<contacts>] [all] [<contacts>]
1043 Check for each contact whether it is actually online or not. The
1044 special keyword all will check upon all contacts with the peekme
1045 option effectively set.
1046 Note: This abuses a bug in the ICQ protocol to figure this out
1047 and thus can stop working at any time. No additional informa‐
1048 tion except online or offline can be found out this way.
1049 peek2 <contacts>
1051 Builtin alias for getauto away contacts. Can be used to detect
1052 presence of users of some clients, but this itself can be
1053 detected by the other user's client. climm since 0.5 will not
1054 be detected by this, but will detect tries from other clients.
1055 peekall [<contacts>]
1057 Builtin alias for peek <contacts> all.
1058 as <nr|uin> <cmd>
1060 Execute climm command cmd as if the connection number nr or for
1061 the UIN uin would be the current one.
1062
1064 tclscript <file>
1065 Execute the tcl script file, which may be given relative to the
1066 climm base directory.
1067 tcl <string>
1069 Execute the tcl command string. Type tcl climm help to get a
1070 list of climm-specific tcl commands.
1071
1073 climm(1), climmrc(5)
1074
1076 This man page was originally created by James Morrison <ja2morri‐
1077 son@student.math.uwaterloo.ca> for a reference to all interactive com‐
1078 mands in climm. It has been adapted to current usage by Rüdiger
1079 Kuhlmann.
1080 climm CLIMM(7)