annotate mcabber/mcabberrc.example @ 339:e4ed1aec2988

Auto-away improvement Auto-away only change the status if it is available (i.e. online) or free-for-chat. Other status are left alone.
author Mikael Berthe <mikael@lilotux.net>
date Mon, 18 Jul 2005 22:47:52 +0100
parents 7bd4ffee9497
children c5a7a7273986
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
169
0ed6099b5a54 [/trunk] Changeset 181 by mikael
mikael
parents: 162
diff changeset
1 # Sample ~/.mcabber/mcabberrc file
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
2
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
3 # The jid will be the following: username@server/resource
85
19f57e681252 [/trunk] Changeset 99 by mikael
mikael
parents: 70
diff changeset
4 # If password is not given, it will be interactively asked for.
19f57e681252 [/trunk] Changeset 99 by mikael
mikael
parents: 70
diff changeset
5 # If port is not given, default Jabber port will be used.
70
5b1249ce812d [/trunk] Changeset 84 by mikael
mikael
parents: 62
diff changeset
6 # Use ssl = 1 to enable SSL
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
7
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
8 set username = yourusername
338
7bd4ffee9497 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 334
diff changeset
9 # Note: if the password contains leading or trailing spaces, you must
7bd4ffee9497 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 334
diff changeset
10 # enclose it with quotes: set password = " example password "
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
11 #set password = yourpassword
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
12 set server = your.jabber.server
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
13 #set port = 5222
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
14 set ssl = 0
232
9a6ba4b38e63 [/trunk] Changeset 245 by mikael
mikael
parents: 218
diff changeset
15 # If you don't know what a resource is, you can leave "mcabber" here.
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
16 set resource = mcabber
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
17 #set priority = 3
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
18
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
19 # Keepalive
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
20 # If you need a ping/keepalive to leave your connection open, you
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
21 # can use the pinginterval. Setting this option to 0 disables the ping.
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
22 # Default value is 40 seconds.
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
23 #set pinginterval = 40
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
24
87
f600615c490d [/trunk] Changeset 101 by mikael
mikael
parents: 85
diff changeset
25 # Set hide_offline_buddies to 1 to display only connected buddies
f600615c490d [/trunk] Changeset 101 by mikael
mikael
parents: 85
diff changeset
26 # in the roster.
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
27 #set hide_offline_buddies = 0
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
28
322
da138cdebf04 Implement auto-away mode
Mikael Berthe <mikael@lilotux.net>
parents: 294
diff changeset
29 # Set the auto-away timeout, in seconds. If set to a value >0,
da138cdebf04 Implement auto-away mode
Mikael Berthe <mikael@lilotux.net>
parents: 294
diff changeset
30 # mcabber will change your status to away if no real activity is detected
339
e4ed1aec2988 Auto-away improvement
Mikael Berthe <mikael@lilotux.net>
parents: 338
diff changeset
31 # (command, message, move in the buddylist...). Note: auto-away only changes
e4ed1aec2988 Auto-away improvement
Mikael Berthe <mikael@lilotux.net>
parents: 338
diff changeset
32 # the status when it is "available" (online) or "free_for_chat".
322
da138cdebf04 Implement auto-away mode
Mikael Berthe <mikael@lilotux.net>
parents: 294
diff changeset
33 #set autoaway = 0
da138cdebf04 Implement auto-away mode
Mikael Berthe <mikael@lilotux.net>
parents: 294
diff changeset
34
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
35 # History logging
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
36 # You can save the messages history: set logging = 1
177
a51ce78a0e2a [/trunk] Changeset 189 by mikael
mikael
parents: 169
diff changeset
37 # You can load (read) the messages history: set load_logs = 1
169
0ed6099b5a54 [/trunk] Changeset 181 by mikael
mikael
parents: 162
diff changeset
38 # Default logging directory (logging_dir) is $HOME/.mcabber/histo/
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
39 set logging = 1
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
40 #set load_logs = 1
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
41 #set logging_dir = /home/mikael/.mcabber/histo/
160
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
42
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
43 # External command for events
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
44 # You can specify a script or process to be launched when an event occurs.
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
45 # For now it is called the following way:
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
46 # $events_command MSG IN jabber@id
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
47 # ... when receiving a message (see sample script in contrib/).
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
48 #set events_command = /home/mikael/.mcabber/eventcmd
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
49
139
8d7e31d37bec [/trunk] Changeset 151 by mikael
mikael
parents: 113
diff changeset
50 # Debug logging
8d7e31d37bec [/trunk] Changeset 151 by mikael
mikael
parents: 113
diff changeset
51 # If you want advanced debug, please specify a file here.
8d7e31d37bec [/trunk] Changeset 151 by mikael
mikael
parents: 113
diff changeset
52 # You can enable debug in main.c before compiling mcabber, too.
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
53 #set debug = /home/mikael/mcabber.log
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
54
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 272
diff changeset
55 # Status messages
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 272
diff changeset
56 # The "message" value will override all others, take care!
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
57 #set message = Unique message status
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
58 #set message_avail = I'm available
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
59 #set message_free = I'm free for chat
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
60 #set message_dnd = Please do not disturb
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
61 #set message_notavail = I'm not available
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
62 #set message_away = I'm away
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
63 #set message_autoaway = Auto-away
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 272
diff changeset
64
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
65 # The colors
267
8d3d5bd52da3 Improve color configuration
mikael@frmp8452
parents: 232
diff changeset
66 # Colors are: black, red, green, yellow, blue, magenta, cyan, white
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
67 #set color_background = blue
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
68 #set color_general = white
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
69 #set color_newmessage = red
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
70 #set color_rosternormal = magenta
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
71 #set color_rosterselect = black
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
72 #set color_backselected = cyan
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
73
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
74 # Aliases
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
75 alias online = status online
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
76 alias away = status away
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
77 alias dnd = status dnd
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
78 alias notavail = status notavail
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
79
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
80 # Key bindings
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
81 # Ctlr-X (24) bound to /roster alternate
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
82 bind 24 = roster alternate
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
83 # F5 (269) bound to /roster toggle_offline (centericq-like, IIRC)
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
84 bind 269 = roster toggle_offline
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
85