Mercurial > hg
annotate mcabber/mcabberrc.example @ 2174:b3742d9ad961
Update ChangeLog
author | Mikael Berthe <mikael@lilotux.net> |
---|---|
date | Sun, 28 Jun 2015 16:59:20 +0200 |
parents | 06669fc1810c |
children | ee3a40ffcd8b |
rev | line source |
---|---|
169 | 1 # Sample ~/.mcabber/mcabberrc file |
62 | 2 |
500
357086193b02
Add a comment about the config. file syntax
Mikael Berthe <mikael@lilotux.net>
parents:
477
diff
changeset
|
3 # Note about this file syntax: |
357086193b02
Add a comment about the config. file syntax
Mikael Berthe <mikael@lilotux.net>
parents:
477
diff
changeset
|
4 # - Leading and trailing spaces are ignored. |
357086193b02
Add a comment about the config. file syntax
Mikael Berthe <mikael@lilotux.net>
parents:
477
diff
changeset
|
5 # - Empty lines and lines beginning with a '#' are ignored. |
357086193b02
Add a comment about the config. file syntax
Mikael Berthe <mikael@lilotux.net>
parents:
477
diff
changeset
|
6 |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
7 # Please provide your Jabber (XMPP) identifier: |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
8 set jid = yourusername@domain |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
9 |
85 | 10 # If password is not given, it will be interactively asked for. |
338
7bd4ffee9497
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
334
diff
changeset
|
11 # 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
|
12 # 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
|
13 #set password = yourpassword |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
14 |
2172
06669fc1810c
Add support for using external password managers
Christian Burkert <post@cburkert.de>
parents:
2170
diff
changeset
|
15 # Read password from output of the given command. |
06669fc1810c
Add support for using external password managers
Christian Burkert <post@cburkert.de>
parents:
2170
diff
changeset
|
16 # This is a way to use password managers like 'pass' in order |
06669fc1810c
Add support for using external password managers
Christian Burkert <post@cburkert.de>
parents:
2170
diff
changeset
|
17 # to avoid writing plain passwords into config files. |
06669fc1810c
Add support for using external password managers
Christian Burkert <post@cburkert.de>
parents:
2170
diff
changeset
|
18 #set password_eval = "your command" |
06669fc1810c
Add support for using external password managers
Christian Burkert <post@cburkert.de>
parents:
2170
diff
changeset
|
19 |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
20 # You can provide a server name if you want mcabber to connect |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
21 # to a specific server. |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
22 #set server = your.jabber.server |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
23 |
1943
11bda6d8daab
Add default server for private messages
Mikael Berthe <mikael@lilotux.net>
parents:
1926
diff
changeset
|
24 # To automatically append the server to the JID in say_to, use this option: |
11bda6d8daab
Add default server for private messages
Mikael Berthe <mikael@lilotux.net>
parents:
1926
diff
changeset
|
25 #set default_server = jabber.org |
11bda6d8daab
Add default server for private messages
Mikael Berthe <mikael@lilotux.net>
parents:
1926
diff
changeset
|
26 |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
27 # If port is not given, mcabber will try to find it out. |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
28 #set port = 5222 |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
29 |
1441
736b82610dfa
mcabberrc: do not set a default resource
Mikael Berthe <mikael@lilotux.net>
parents:
1437
diff
changeset
|
30 # If you don't know what a resource is, do not set it. |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
31 # Set disable_random_resource to 1 if you don't want mcabber to add a random |
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
32 # suffix to the resource name. |
1441
736b82610dfa
mcabberrc: do not set a default resource
Mikael Berthe <mikael@lilotux.net>
parents:
1437
diff
changeset
|
33 #set resource = mcabber |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
34 #set disable_random_resource = 0 |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
35 |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
36 #set priority = 3 |
1419
fb438482b28e
New option to customize the away/notavail priority (Michael Gehring)
Mikael Berthe <mikael@lilotux.net>
parents:
1417
diff
changeset
|
37 #set priority_away = 0 |
62 | 38 |
1446
49c8be874344
Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1444
diff
changeset
|
39 # Set 'ignore_self_presence' to 1 if you do not want to see your own |
49c8be874344
Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1444
diff
changeset
|
40 # presence in your roster (default: 0). |
49c8be874344
Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1444
diff
changeset
|
41 set ignore_self_presence = 1 |
49c8be874344
Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1444
diff
changeset
|
42 |
1598 | 43 # SSL/TLS options: |
44 # TLS is now regarded as the default encryption for connecting to jabber. | |
1605
79f3b780821a
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
1598
diff
changeset
|
45 # You can require TLS by setting tls to 1. If your jabber server |
1598 | 46 # still doesn't support TLS, you can use the old-style SSL by setting |
1605
79f3b780821a
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
1598
diff
changeset
|
47 # ssl to 1. It's not possible to use old-style SSL and TLS together. |
79f3b780821a
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
1598
diff
changeset
|
48 #set ssl = 0 |
1598 | 49 set tls = 1 |
50 # Moreover, it's possible to check whether the fingerprint of the | |
51 # ssl certificate matches ssl_fingerprint. | |
52 # You can get the fingerprint of your server either with gnutls or openssl: | |
53 # 1. gnutls-cli -p 5223 $your_server | |
54 # 2. openssl s_client -connect $your_server:5223 | \ | |
55 # openssl x509 -fingerprint -md5 -noout | |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
56 #set ssl_fingerprint = 97:5C:00:3F:1D:77:45:25:E2:C5:70:EC:83:C8:87:EE |
1598 | 57 # Set ssl_ignore_checks to 1 to disable all certificate checks except the |
58 # fingerprint check. | |
59 #set ssl_ignore_checks = 0 | |
938
40175f3dcef7
SSL server certificate verification
Jefferson Ogata <ogata@antibozo.net>
parents:
919
diff
changeset
|
60 |
1042
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
61 # PGP support |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
62 # Set pgp to 1 to enable OpenPGP. |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
63 # To sign outgoing messages, select your private key id with |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
64 # the pgp_private_key option. You cannot change these options once |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
65 # mcabber is running. |
1068
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
66 # Note: you can get the Key Id with gpg: "gpg --list-keys --keyid-format long" |
1042
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
67 #set pgp = 0 |
1068
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
68 #set pgp_private_key = "C9940A9BB0B92210" |
1042
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
69 # |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
70 # You can set your PGP passhrase here, although it's NOT advised. |
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
71 #set pgp_passphrase = "PGPpassword" |
1313
d1d12a09b04a
Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents:
1311
diff
changeset
|
72 # |
d1d12a09b04a
Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents:
1311
diff
changeset
|
73 # If you don't like the default number of passphrase retries (2), you |
d1d12a09b04a
Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents:
1311
diff
changeset
|
74 # can change it here. If this number is < 0, mcabber will keep asking |
d1d12a09b04a
Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents:
1311
diff
changeset
|
75 # until the passphrase is good. |
1713
5acc6eb01988
Fix typo in config. file (spotted by calico.jeff)
Mikael Berthe <mikael@lilotux.net>
parents:
1679
diff
changeset
|
76 #set pgp_passphrase_retries = 2 |
1042
8a395c2cafc4
Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents:
993
diff
changeset
|
77 |
659
e61aa455c61b
MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents:
635
diff
changeset
|
78 # Conference nickname |
e61aa455c61b
MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents:
635
diff
changeset
|
79 # This nickname is used when joining a room, when no nick is explicitly |
e61aa455c61b
MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents:
635
diff
changeset
|
80 # specified by the user. Note that when the nickname option is not set, |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
81 # the jid variable can be used. |
659
e61aa455c61b
MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents:
635
diff
changeset
|
82 #set nickname = Abitbol |
e61aa455c61b
MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents:
635
diff
changeset
|
83 |
429 | 84 # Proxy |
85 # mcabber can use a proxy if it supports the CONNECT method | |
86 # The proxy_user/proxy_pass variables are optional. | |
87 #set proxy_host = "proxy-hostname" | |
88 #set proxy_port = 3128 | |
89 #set proxy_user = "username" | |
90 #set proxy_pass = "password" | |
91 | |
113 | 92 # Keepalive |
93 # If you need a ping/keepalive to leave your connection open, you | |
94 # can use the pinginterval. Setting this option to 0 disables the ping. | |
95 # Default value is 40 seconds. | |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
96 #set pinginterval = 40 |
113 | 97 |
919
653c1cdfb589
Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents:
899
diff
changeset
|
98 # Language |
653c1cdfb589
Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents:
899
diff
changeset
|
99 # Help files have been translated into a few languages. |
1679
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
100 # You can set lang to a semicolon separated list of the following |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
101 # values: en, cs, de, fr, it, nl, pl, ru, uk. If you omit this, |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
102 # mcabber will try to autodetect it from your locale, with fallback |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
103 # to en. |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
104 # You also can specify a list of directories, where help is located, |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
105 # for example, if your mcabber is installed with another prefix than |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
106 # your modules. |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
107 # This may be convenient to print help not into the status buffer, but into |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
108 # currently opened buffer. For that set help_to_current option. |
919
653c1cdfb589
Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents:
899
diff
changeset
|
109 #set lang = en |
1679
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
110 #set help_dirs = "/usr/share/mcabber/help;~/share/mcabber/help" |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
111 #set help_to_current = 0 |
919
653c1cdfb589
Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents:
899
diff
changeset
|
112 |
1206
abc5847d1613
Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1204
diff
changeset
|
113 # Aspell |
abc5847d1613
Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1204
diff
changeset
|
114 # If your mcabber has been built with Aspell support, you can enable spell |
abc5847d1613
Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1204
diff
changeset
|
115 # checking with the following options (you can't change them once mcabber is |
abc5847d1613
Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1204
diff
changeset
|
116 # running). |
1590
8d1bcc83ae32
Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents:
1585
diff
changeset
|
117 #set spell_enable = 1 |
2170
282531385f34
Multilanguage spell checking
Dmitry Potapov <potapov.d@gmail.com>
parents:
2148
diff
changeset
|
118 #set spell_lang = en_US ru_RU |
1590
8d1bcc83ae32
Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents:
1585
diff
changeset
|
119 #set spell_encoding = iso8859-1 |
8d1bcc83ae32
Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents:
1585
diff
changeset
|
120 #set spell_encoding = UTF-8 |
1206
abc5847d1613
Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1204
diff
changeset
|
121 |
1127
fddf2fef7b83
Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents:
1120
diff
changeset
|
122 # History |
fddf2fef7b83
Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents:
1120
diff
changeset
|
123 # Number of lines to remember for the command line history |
fddf2fef7b83
Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents:
1120
diff
changeset
|
124 # (default: 0, unlimited). |
fddf2fef7b83
Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents:
1120
diff
changeset
|
125 set cmdhistory_lines = 250 |
fddf2fef7b83
Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents:
1120
diff
changeset
|
126 |
1311
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
127 # You can set up a mask to filter buddies and display them according to |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
128 # their status. The mask should contain the shortcut letters of the |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
129 # status you want to see ([o]nline, [f]ree_for_chat, [d]o_not_disturb, |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
130 # [n]ot_available, [a]way, [_]offline). |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
131 # For example, to display everybody the filter should be "ofdna_" (default). |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
132 # To display only the connected buddies, use "ofdna". |
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
133 # Please note that this option is only used at startup (once mcabber is |
1318
cb49b9a59bcf
Fix double typo in rc file
Mikael Berthe <mikael@lilotux.net>
parents:
1313
diff
changeset
|
134 # running you can use "/roster display"). |
1311
0dda8238af21
Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents:
1297
diff
changeset
|
135 #set roster_display_filter = ofdna_ |
62 | 136 |
2009
a859ed648638
Replace the option « no_space_before_items » with « roster_no_leading_space ».
Simon Jacquin <simon@jacquin.me>
diff
changeset
|
137 # By default, mcabber adds a leading space before each buddy in the roster. You |
a859ed648638
Replace the option « no_space_before_items » with « roster_no_leading_space ».
Simon Jacquin <simon@jacquin.me>
diff
changeset
|
138 # can remove it to gain a little space. |
a859ed648638
Replace the option « no_space_before_items » with « roster_no_leading_space ».
Simon Jacquin <simon@jacquin.me>
diff
changeset
|
139 #set roster_no_leading_space = 0 |
2007
6c02ccb14c1c
Added an option to remove the extra space before items in the roster.
Simon Jacquin <simon@jacquin.me>
parents:
2000
diff
changeset
|
140 |
1926
c1f9a4d47e05
Add option 'completion_ignore_case'
Mikael Berthe <mikael@lilotux.net>
parents:
1839
diff
changeset
|
141 # By default command line completion is case-sensitive; this can be changed |
c1f9a4d47e05
Add option 'completion_ignore_case'
Mikael Berthe <mikael@lilotux.net>
parents:
1839
diff
changeset
|
142 # by setting the option 'completion_ignore_case' to 1. |
c1f9a4d47e05
Add option 'completion_ignore_case'
Mikael Berthe <mikael@lilotux.net>
parents:
1839
diff
changeset
|
143 #set completion_ignore_case = 0 |
c1f9a4d47e05
Add option 'completion_ignore_case'
Mikael Berthe <mikael@lilotux.net>
parents:
1839
diff
changeset
|
144 |
2148
7a0df2e5da19
Add the 'carbons' option to mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
2123
diff
changeset
|
145 # Message Carbons (XEP-0280) |
7a0df2e5da19
Add the 'carbons' option to mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
2123
diff
changeset
|
146 # If you want to enable Message Carbons at startup (and if your server |
7a0df2e5da19
Add the 'carbons' option to mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
2123
diff
changeset
|
147 # supports them), set the 'carbons' option to 1. Default is 0. |
7a0df2e5da19
Add the 'carbons' option to mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
2123
diff
changeset
|
148 #set carbons = 1 |
7a0df2e5da19
Add the 'carbons' option to mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
2123
diff
changeset
|
149 |
1714 | 150 # Typing notifications, Chat States, Events (XEP-22/85) |
993
0759f4c7da68
Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents:
983
diff
changeset
|
151 # Set disable_chatstates to 1 if you don't want to use typing notifications. |
0759f4c7da68
Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents:
983
diff
changeset
|
152 # Note: changing this option once mcabber is running has no effect. |
0759f4c7da68
Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents:
983
diff
changeset
|
153 #set disable_chatstates = 0 |
0759f4c7da68
Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents:
983
diff
changeset
|
154 |
113 | 155 # History logging |
156 # You can save the messages history: set logging = 1 | |
1144
b8f5fe2d666a
Add option "logging_ignore_status"
Mikael Berthe <mikael@lilotux.net>
parents:
1141
diff
changeset
|
157 # Set 'logging_ignore_status' to 1 if you do not want to save status changes |
b8f5fe2d666a
Add option "logging_ignore_status"
Mikael Berthe <mikael@lilotux.net>
parents:
1141
diff
changeset
|
158 # (and status messages) to the log files (default: 0). |
177 | 159 # You can load (read) the messages history: set load_logs = 1 |
899
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
160 # If you enable load_logs, you can use the 'max_history_age' setting below. |
169 | 161 # Default logging directory (logging_dir) is $HOME/.mcabber/histo/ |
356
a30ca1b77fa2
Disable logging by default in the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
355
diff
changeset
|
162 # Defaults for logging, load_logs are 0 (disabled) |
376
d37d8d661115
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
374
diff
changeset
|
163 # Note: the logging directory must exist if you enable logging, mcabber |
d37d8d661115
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
374
diff
changeset
|
164 # will not create it. |
1141
5be2408a6534
Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents:
1136
diff
changeset
|
165 # Note: these options, except 'max_history_age' and 'max_history_blocks', |
5be2408a6534
Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents:
1136
diff
changeset
|
166 # are used at startup time. |
356
a30ca1b77fa2
Disable logging by default in the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
355
diff
changeset
|
167 #set logging = 1 |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
168 #set load_logs = 1 |
1167
9726c78a91f3
Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents:
1166
diff
changeset
|
169 #set logging_dir = ~/.mcabber/histo/ |
1144
b8f5fe2d666a
Add option "logging_ignore_status"
Mikael Berthe <mikael@lilotux.net>
parents:
1141
diff
changeset
|
170 #set logging_ignore_status = 1 |
160 | 171 |
477 | 172 # Set log_muc_conf to 1 to enable MUC chatrooms logging (default = 0) |
635
d4119cb85aeb
New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents:
619
diff
changeset
|
173 #set log_muc_conf = 1 |
d4119cb85aeb
New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents:
619
diff
changeset
|
174 # Set load_muc_logs to 1 to read MUC chatrooms logs (default = 0). These |
d4119cb85aeb
New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents:
619
diff
changeset
|
175 # logs will be displayed in the buffer window _before_ any history received |
d4119cb85aeb
New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents:
619
diff
changeset
|
176 # from the server. |
d4119cb85aeb
New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents:
619
diff
changeset
|
177 #set load_muc_logs = 0 |
477 | 178 |
899
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
179 # When load_logs (or load_muc_logs) is enabled, you can specify a maximum |
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
180 # number of history days to load into memory with max_history_age. |
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
181 # Default = 0 (disabled -- everything is loaded) |
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
182 # Note: this option is only used when reading history files, not later. |
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
183 #set max_history_age = 0 |
1437
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
184 |
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
185 # mcabber can store the list of unread messages in a state file, |
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
186 # so that the message flags are set back at next startup. |
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
187 # Note that 'logging' must be enabled for this feature to work. |
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
188 #set statefile = ~/.mcabber/mcabber.state |
071c8170b7de
Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents:
1427
diff
changeset
|
189 |
1141
5be2408a6534
Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents:
1136
diff
changeset
|
190 # You can specify a maximum number of data blocks per buffer (1 block contains |
5be2408a6534
Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents:
1136
diff
changeset
|
191 # about 8kB). The default is 0 (unlimited). If set, this value must be > 2. |
1757
6e55f9776d5d
Uncomment max_history_blocks in the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1756
diff
changeset
|
192 set max_history_blocks = 8 |
899
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
193 |
619
44ddf9bec3a5
Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents:
550
diff
changeset
|
194 # IQ settings |
44ddf9bec3a5
Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents:
550
diff
changeset
|
195 # Set iq_version_hide_os to 1 if you do not want to allow people to retrieve |
899
a833f3d6119a
Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents:
837
diff
changeset
|
196 # your OS version. |
619
44ddf9bec3a5
Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents:
550
diff
changeset
|
197 #set iq_version_hide_os = 0 |
1254
401639413340
More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents:
1207
diff
changeset
|
198 # |
2066
69699ba3010f
Add 'iq_version_hide', 'iq_version_hide_version'
Mikael Berthe <mikael@lilotux.net>
parents:
2065
diff
changeset
|
199 # Set iq_version_hide_version to 1 if you do not want to allow people to |
69699ba3010f
Add 'iq_version_hide', 'iq_version_hide_version'
Mikael Berthe <mikael@lilotux.net>
parents:
2065
diff
changeset
|
200 # retrieve your mcabber version. |
69699ba3010f
Add 'iq_version_hide', 'iq_version_hide_version'
Mikael Berthe <mikael@lilotux.net>
parents:
2065
diff
changeset
|
201 #set iq_version_hide_version = 0 |
69699ba3010f
Add 'iq_version_hide', 'iq_version_hide_version'
Mikael Berthe <mikael@lilotux.net>
parents:
2065
diff
changeset
|
202 # |
2067
79659eb4f66f
Rename 'iq_version_hide_time' to 'iq_time_hide'
Mikael Berthe <mikael@lilotux.net>
parents:
2066
diff
changeset
|
203 # Set iq_time_hide to 1 if you do not want to allow people to retrieve |
2065
c09fc3834c69
Add option 'iq_version_hide_time'
Mikael Berthe <mikael@lilotux.net>
parents:
2028
diff
changeset
|
204 # your OS time. |
2067
79659eb4f66f
Rename 'iq_version_hide_time' to 'iq_time_hide'
Mikael Berthe <mikael@lilotux.net>
parents:
2066
diff
changeset
|
205 #set iq_time_hide = 0 |
2065
c09fc3834c69
Add option 'iq_version_hide_time'
Mikael Berthe <mikael@lilotux.net>
parents:
2028
diff
changeset
|
206 # |
1254
401639413340
More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents:
1207
diff
changeset
|
207 # Set iq_last_disable to 1 if you want to disable response to jabber:iq:last |
1261
704adf4df2d0
Send service-unavailable when Last Activity is disabled
Mikael Berthe <mikael@lilotux.net>
parents:
1254
diff
changeset
|
208 # queries (XEP-0012). Set iq_last_disable_when_notavail to 1 if you want |
704adf4df2d0
Send service-unavailable when Last Activity is disabled
Mikael Berthe <mikael@lilotux.net>
parents:
1254
diff
changeset
|
209 # to disable Last Activity reports only when the not-available status is set. |
704adf4df2d0
Send service-unavailable when Last Activity is disabled
Mikael Berthe <mikael@lilotux.net>
parents:
1254
diff
changeset
|
210 # (Default is 0 for both options) |
1254
401639413340
More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents:
1207
diff
changeset
|
211 #set iq_last_disable = 0 |
1263
d1a111f39b7a
Fix typo in mcabberrc sample file
Mikael Berthe <mikael@lilotux.net>
parents:
1261
diff
changeset
|
212 #set iq_last_disable_when_notavail = 1 |
1498
2eaa52d314e3
Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents:
1496
diff
changeset
|
213 # |
2eaa52d314e3
Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents:
1496
diff
changeset
|
214 # Set iq_hide_requests to 1 if you don't want received IQ requests to be |
2eaa52d314e3
Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents:
1496
diff
changeset
|
215 # displayed in the status window (default: 0). |
2eaa52d314e3
Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents:
1496
diff
changeset
|
216 #set iq_hide_requests = 1 |
619
44ddf9bec3a5
Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents:
550
diff
changeset
|
217 |
1622
90ecb027d1e3
Add modules_dir to example mcabberrc
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1616
diff
changeset
|
218 # Modules |
1628 | 219 # If mcabber is built with modules support, you can specify the path |
1679
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
220 # to the directory where your modules reside. Though, default compiled-in |
b2504df1c910
Update mcabberrc.example
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1628
diff
changeset
|
221 # value should be appropriate. |
1622
90ecb027d1e3
Add modules_dir to example mcabberrc
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1616
diff
changeset
|
222 #set modules_dir = /usr/lib/mcabber/ |
90ecb027d1e3
Add modules_dir to example mcabberrc
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1616
diff
changeset
|
223 |
675
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
224 # Beep |
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
225 # Set beep_on_message to 1 if you want mcabber to beep when receiving |
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
226 # a new message (except in chatrooms). If you want a more sophisticated |
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
227 # system (e.g. play a sound), have a look at 'events_command' below. |
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
228 #set beep_on_message = 0 |
ae7016aae014
New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents:
659
diff
changeset
|
229 |
160 | 230 # External command for events |
231 # You can specify a script or process to be launched when an event occurs. | |
1129
1a109ebf3f24
Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents:
1127
diff
changeset
|
232 # Set 'events_ignore_active_window' to 1 if you don't want the script to |
1a109ebf3f24
Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents:
1127
diff
changeset
|
233 # be run for a message to the current active window (default: 0). |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
234 # |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
235 # If 'event_log_files' is set, a file is created and contains the body of |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
236 # the message (incoming messages only); the file name is the last parameter. |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
237 # If you enable this, you can specify the directory mcabber will use to |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
238 # create these messages with the 'event_log_dir' variable (default is the |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
239 # system temp dir, or MCABBERTMPDIR environment variable). Please note |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
240 # that mcabber won't delete these files, it's your script's job. |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
241 # |
355
c5a7a7273986
Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents:
339
diff
changeset
|
242 # The command is called the following way: |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
243 # $events_command MSG IN jabber@id [file] (when receiving a message) |
355
c5a7a7273986
Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents:
339
diff
changeset
|
244 # $events_command MSG OUT jabber@id (when sending a message) |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
245 # $events_command MSG MUC room_id [file] (when receiving a MUC message) |
355
c5a7a7273986
Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents:
339
diff
changeset
|
246 # $events_command STATUS X jabber@id (new buddy status is X) |
1839
f0a07658e009
Update UNREAD event data
Mikael Berthe <mikael@lilotux.net>
parents:
1793
diff
changeset
|
247 # $events_command UNREAD "N x y z" (number of unread buddy buffers) |
f0a07658e009
Update UNREAD event data
Mikael Berthe <mikael@lilotux.net>
parents:
1793
diff
changeset
|
248 # (x=attention y=muc unread buffers z=muc unread buffers with attention sign) |
355
c5a7a7273986
Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents:
339
diff
changeset
|
249 # See sample script in contrib/ directory. |
1167
9726c78a91f3
Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents:
1166
diff
changeset
|
250 #set events_command = ~/.mcabber/eventcmd |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
251 # |
1129
1a109ebf3f24
Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents:
1127
diff
changeset
|
252 #set events_ignore_active_window = 0 |
1a109ebf3f24
Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents:
1127
diff
changeset
|
253 # |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
254 #set event_log_files = 0 |
1167
9726c78a91f3
Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents:
1166
diff
changeset
|
255 #set event_log_dir = ~/.mcabber/event_files |
113 | 256 |
1447
ba706e97d6ec
Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents:
1446
diff
changeset
|
257 # If you set 'eventcmd_use_nickname' to 1, mcabber will pass the nickname |
ba706e97d6ec
Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents:
1446
diff
changeset
|
258 # (if it is defined) to the event script instead of the JID (default: 0). |
ba706e97d6ec
Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents:
1446
diff
changeset
|
259 #set eventcmd_use_nickname = 0 |
ba706e97d6ec
Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents:
1446
diff
changeset
|
260 |
676
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
261 # External command status check |
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
262 # You can request mcabber to inspect exit status value after each |
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
263 # events_command. If this option is set, mcabber will beep if the |
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
264 # exit value is 2. |
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
265 #set eventcmd_checkstatus = 0 |
80d4959422ca
New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents:
675
diff
changeset
|
266 |
1353
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
267 # Internal hooks |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
268 # You can ask mcabber to execute an internal command when a special event |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
269 # occurs (for example when it connects to the server). |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
270 # |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
271 # 'hook-post-connect' is executed when mcabber has connected to the server |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
272 # and the roster has been received. |
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
273 #set hook-post-connect = status dnd |
1354
c373ff3fe7e1
Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1353
diff
changeset
|
274 # |
c373ff3fe7e1
Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1353
diff
changeset
|
275 # 'hook-pre-disconnect' is executed just before mcabber disconnects from |
c373ff3fe7e1
Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1353
diff
changeset
|
276 # the server. |
c373ff3fe7e1
Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1353
diff
changeset
|
277 #set hook-pre-disconnect = say_to foo@bar Goodbye! |
1353
7caedca15e50
Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents:
1348
diff
changeset
|
278 |
1426
a64778f5f26b
Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents:
1419
diff
changeset
|
279 # FIFO |
a64778f5f26b
Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents:
1419
diff
changeset
|
280 # mcabber can create a FIFO named pipe and listen to this pipe for commands. |
1944
098b7b5b4854
Add a comment about the FIFO module to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1943
diff
changeset
|
281 # Don't forget to load the FIFO module if you plan to use this feature! |
1490
9d5a2f45addb
Remove obsolete note in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1482
diff
changeset
|
282 # Default: disabled. |
1526
eefa0ae248d8
Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1520
diff
changeset
|
283 # Set 'fifo_hide_commands' to 1 if you don't want to see the FIFO commands |
1427
a8eb9aba2ed2
Add option 'fifo_hide_commands'
Mikael Berthe <mikael@lilotux.net>
parents:
1426
diff
changeset
|
284 # in the log window (they will still be written to the tracelog file). |
1526
eefa0ae248d8
Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1520
diff
changeset
|
285 # When FIFO is configured, you can turn it off and on in real time with |
eefa0ae248d8
Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1520
diff
changeset
|
286 # the 'fifo_ignore' option (default: 0). When set to 1, the FIFO input is |
eefa0ae248d8
Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1520
diff
changeset
|
287 # still read but it is discarded. |
1426
a64778f5f26b
Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents:
1419
diff
changeset
|
288 #set fifo_name = ~/.mcabber/mcabber.fifo |
1427
a8eb9aba2ed2
Add option 'fifo_hide_commands'
Mikael Berthe <mikael@lilotux.net>
parents:
1426
diff
changeset
|
289 #set fifo_hide_commands = 0 |
1526
eefa0ae248d8
Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1520
diff
changeset
|
290 #set fifo_ignore = 0 |
1944
098b7b5b4854
Add a comment about the FIFO module to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1943
diff
changeset
|
291 # |
098b7b5b4854
Add a comment about the FIFO module to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1943
diff
changeset
|
292 #module load fifo |
1426
a64778f5f26b
Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents:
1419
diff
changeset
|
293 |
1974 | 294 # URL extractor |
295 # Set 'url_regex' to a regular expression matching urls. If it matches an | |
296 # url in an incoming messages, it'll print it to the log window. | |
297 # Don't forget to load the urlregex module if you plan to use this feature! | |
298 #set url_regex = "(((https?|ftps?|nntp)://)|www[.][-a-z0-9.]+|(mailto:|news:))(%[0-9A-F]{2}|[-_.!~*';/?:@&=+$,#[:alnum:]])+" | |
299 # | |
300 #module load urlregex | |
301 | |
302 | |
374
bd5638c21834
Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents:
364
diff
changeset
|
303 # Traces logging |
bd5638c21834
Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents:
364
diff
changeset
|
304 # If you want advanced traces, please specify a file and a level here. |
1734
eae4a2637f2c
Fix small typo in config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1714
diff
changeset
|
305 # There are currently 4 tracelog levels: |
374
bd5638c21834
Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents:
364
diff
changeset
|
306 # lvl 1: most events of the log window are written to the file |
1616
4c7104ec5f3b
Add 2 debugging levels (for 'tracelog_level')
Mikael Berthe <mikael@lilotux.net>
parents:
1610
diff
changeset
|
307 # lvl 2: Loudmouth verbose logging |
4c7104ec5f3b
Add 2 debugging levels (for 'tracelog_level')
Mikael Berthe <mikael@lilotux.net>
parents:
1610
diff
changeset
|
308 # lvl 3: debug logging (XML, etc.) |
4c7104ec5f3b
Add 2 debugging levels (for 'tracelog_level')
Mikael Berthe <mikael@lilotux.net>
parents:
1610
diff
changeset
|
309 # lvl 4: noisy debug logging (Loudmouth parser...) |
374
bd5638c21834
Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents:
364
diff
changeset
|
310 # Default is level 0, no trace logging |
bd5638c21834
Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents:
364
diff
changeset
|
311 #set tracelog_level = 1 |
1167
9726c78a91f3
Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents:
1166
diff
changeset
|
312 #set tracelog_file = ~/.mcabber/mcabber.log |
113 | 313 |
525
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
314 # Set the auto-away timeout, in seconds. If set to a value >0, |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
315 # mcabber will change your status to away if no real activity is detected |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
316 # (command, message, move in the buddylist...). Note: auto-away only changes |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
317 # the status when it is "available" (online) or "free_for_chat". |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
318 # See 'message_autoaway' below. |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
319 #set autoaway = 0 |
c7f94f6e51f0
Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents:
522
diff
changeset
|
320 |
819
c2d7d9dd4193
New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents:
808
diff
changeset
|
321 # Message blocking |
823
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
322 # Set 'block_unsubscribed' to 1 if you want to block (drop) incoming |
819
c2d7d9dd4193
New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents:
808
diff
changeset
|
323 # messages from people you haven't authorized. (default: 0) |
c2d7d9dd4193
New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents:
808
diff
changeset
|
324 #set block_unsubscribed = 0 |
823
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
325 # |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
326 # Set 'delete_on_reject' to 1 if you want to delete buddies from your |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
327 # roster when you reject their subscription request. (default: 0) |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
328 # (See documentation for /event) |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
329 # The buddy is actually deleted only if there is no other subscription, |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
330 # so for example if you are subscribed to this buddy's presence updates it |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
331 # won't be deleted. |
19c615fd071e
New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents:
819
diff
changeset
|
332 #set delete_on_reject = 0 |
819
c2d7d9dd4193
New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents:
808
diff
changeset
|
333 |
837
7c74eef1d0e0
New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents:
823
diff
changeset
|
334 # MUC |
1166
c4da23bf8958
Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents:
1144
diff
changeset
|
335 # Set 'muc_flag_joins' to 1 if you want the MUC rooms to be flagged in |
c4da23bf8958
Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents:
1144
diff
changeset
|
336 # the roster when somebody joins a room. Set it to 2 if you want a flag |
c4da23bf8958
Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents:
1144
diff
changeset
|
337 # for leaves too. |
c4da23bf8958
Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents:
1144
diff
changeset
|
338 #set muc_flag_joins = 0 |
1377
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
339 # Set 'muc_print_status' to see status changes in MUC rooms: |
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
340 # 1: (none) do not display joining/leaving members |
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
341 # 2: (in_and_out) display joining/leaving members |
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
342 # 3: (all) display joining/leaving members and member status changes |
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
343 # (default: in_and_out) |
cd9182f0b5c7
Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents:
1354
diff
changeset
|
344 #set muc_print_status = 2 |
837
7c74eef1d0e0
New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents:
823
diff
changeset
|
345 # Set 'muc_auto_whois' to 1 if you want to call /room whois each time |
7c74eef1d0e0
New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents:
823
diff
changeset
|
346 # somebody joins a room. (default: 0) |
7c74eef1d0e0
New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents:
823
diff
changeset
|
347 #set muc_auto_whois = 0 |
2006 | 348 # Set 'muc_print_jid' to see real jid in non-anonynmous room when somebody |
349 # joins. This setting will be ignored when auto_whois is enabled. | |
350 # 0: only nick (don't print jid even if available) | |
351 # 1: nick and bare jid | |
352 # 2: nick and full jid with resource | |
353 #set muc_print_jid = 1 | |
1207
8f0af3b88cef
MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents:
1206
diff
changeset
|
354 # |
8f0af3b88cef
MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents:
1206
diff
changeset
|
355 # Set 'muc_disable_nick_hl' to 1 if you don't want mcabber to color lines |
8f0af3b88cef
MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents:
1206
diff
changeset
|
356 # containing your nickname in a MUC room. |
8f0af3b88cef
MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents:
1206
diff
changeset
|
357 #set muc_disable_nick_hl = 0 |
1756
e2c084204583
Add (optional) suffix after nick completion in Multi-User Chats
Mikael Berthe <mikael@lilotux.net>
parents:
1734
diff
changeset
|
358 # |
1793
c3ddb52f1055
Rename completion_muc_suffix to muc_completion_suffix
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1757
diff
changeset
|
359 # Set 'muc_completion_suffix' if you want mcabber to append a string to |
1756
e2c084204583
Add (optional) suffix after nick completion in Multi-User Chats
Mikael Berthe <mikael@lilotux.net>
parents:
1734
diff
changeset
|
360 # suggested nicknames (only at the beginning of a line), like ":" or ",". |
e2c084204583
Add (optional) suffix after nick completion in Multi-User Chats
Mikael Berthe <mikael@lilotux.net>
parents:
1734
diff
changeset
|
361 # (Default: none) |
1793
c3ddb52f1055
Rename completion_muc_suffix to muc_completion_suffix
Myhailo Danylenko <isbear@ukrpost.net>
parents:
1757
diff
changeset
|
362 #set muc_completion_suffix = ": " |
1980
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
363 # |
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
364 # Set 'muc_bookmark_autoupdate' to 1 if you want changes made to room options |
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
365 # be stored automatically on server. Otherwise you'll have to manually use |
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
366 # command /room bookmark, or changes will not be permanent (for session only). |
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
367 # This setting will not add any bookmark, only update already existing ones. |
3bcc57751283
Add 'muc_bookmark_autoupdate' (Hermitifier)
Mikael Berthe <mikael@lilotux.net>
parents:
1974
diff
changeset
|
368 #set muc_bookmark_autoupdate = 0 |
837
7c74eef1d0e0
New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents:
823
diff
changeset
|
369 |
511 | 370 # Status messages |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
371 # 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
|
372 #set message = Unique message status |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
373 #set message_avail = I'm available |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
374 #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
|
375 #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
|
376 #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
|
377 #set message_away = I'm away |
522 | 378 # |
379 # The auto-away message is only used when 'autoaway' is set. The previous | |
380 # message will be restored when leaving auto-away status. If this message | |
381 # isn't defined, the status message will stay unchanged. | |
530 | 382 set message_autoaway = Auto-away (idle) |
294
871e53769084
Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents:
272
diff
changeset
|
383 |
1386 | 384 # Escape timeout delay (ESCDELAY) |
385 # The ESCDELAY variable specifies the time, in milliseconds, for which | |
386 # the ncurses interface will await a character sequence. | |
387 # The default is 1000 (1 second). | |
388 # If you want mcabber to react faster after hitting Escape, you can lower | |
389 # this value by setting the ESCDELAY environment variable or setting the | |
390 # 'escdelay' option. | |
391 set escdelay = 50 | |
392 | |
511 | 393 # Colors |
267 | 394 # Colors are: black, red, green, yellow, blue, magenta, cyan, white |
739
0d5fb1d9077c
Allow "bright" text colors
Mikael Berthe <mikael@lilotux.net>
parents:
736
diff
changeset
|
395 # For text colors (i.e. not background and bg* colors) you can also use |
0d5fb1d9077c
Allow "bright" text colors
Mikael Berthe <mikael@lilotux.net>
parents:
736
diff
changeset
|
396 # the "bright" prefix to get a bright/bold color. Example: brightblue |
1417
783b47c9d963
Allow more than the 16 default colors (patch from mjs)
Mikael Berthe <mikael@lilotux.net>
parents:
1386
diff
changeset
|
397 # You can use the "default" color, too (i.e. for transparent background). |
783b47c9d963
Allow more than the 16 default colors (patch from mjs)
Mikael Berthe <mikael@lilotux.net>
parents:
1386
diff
changeset
|
398 # If your terminal supports 256 colors, you can use the color number |
783b47c9d963
Allow more than the 16 default colors (patch from mjs)
Mikael Berthe <mikael@lilotux.net>
parents:
1386
diff
changeset
|
399 # directly (16-255). |
712 | 400 # |
1417
783b47c9d963
Allow more than the 16 default colors (patch from mjs)
Mikael Berthe <mikael@lilotux.net>
parents:
1386
diff
changeset
|
401 # Have a look at the contrib/themes/ directory to see some sample |
739
0d5fb1d9077c
Allow "bright" text colors
Mikael Berthe <mikael@lilotux.net>
parents:
736
diff
changeset
|
402 # color settings. |
0d5fb1d9077c
Allow "bright" text colors
Mikael Berthe <mikael@lilotux.net>
parents:
736
diff
changeset
|
403 # |
712 | 404 # background: background color of the chat window and the log window |
405 # general: text color in the chat window and the log window | |
1268
dbc907b2d92f
Add configurable colors for info and incoming messages (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1267
diff
changeset
|
406 # info: text color in the chat window for info messages |
dbc907b2d92f
Add configurable colors for info and incoming messages (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1267
diff
changeset
|
407 # msgin: text color in the chat window for incoming messages |
785
7e0562e3bc83
Replace color_highlight with color_msgout
Mikael Berthe <mikael@lilotux.net>
parents:
766
diff
changeset
|
408 # msgout: text color in the chat window for outgoing messages |
1204
e802ec0c02d2
Basic support for nick highlighting in MUC rooms (the whole line is colored)
Mikael Berthe <mikael@lilotux.net>
parents:
1188
diff
changeset
|
409 # msghl: text color in the chat window for highlighted messages (MUC) |
712 | 410 # bgstatus: background color of the status lines |
411 # status: text color of the status lines | |
2028
7b5bd6ad83b4
Add 'color_log' (text color in the log window)
Mikael Berthe <mikael@lilotux.net>
parents:
2013
diff
changeset
|
412 # log: text color in the log window |
712 | 413 # roster: text color of the roster (buddylist) normal items |
414 # bgrostersel: background color of the selected roster item | |
415 # rostersel: text color of the selected roster item | |
723
23068490d063
Add text color when the selected buddy has an unread message
Mikael Berthe <mikael@lilotux.net>
parents:
719
diff
changeset
|
416 # rosterselmsg:text color of the selected roster item, if there is a new msg |
712 | 417 # rosternewmsg: text color of items with unread messages |
2070
dd8ae0abfc68
mcabberrc: Add missing description for color_readmark
Mikael Berthe <mikael@lilotux.net>
parents:
2067
diff
changeset
|
418 # readmark: text color of the "read mark" line in buffers |
2090
16b04d64ec88
Add option to highlight timestamp added by server.
Hermitifier
parents:
2070
diff
changeset
|
419 # timestamp: text color in the chat window for delayed timestamps |
712 | 420 # |
736
a8fa82e611c3
Change default background color in the sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
731
diff
changeset
|
421 #set color_background = black |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
422 #set color_general = white |
1281 | 423 #set color_info = white |
1268
dbc907b2d92f
Add configurable colors for info and incoming messages (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1267
diff
changeset
|
424 #set color_msgin = white |
785
7e0562e3bc83
Replace color_highlight with color_msgout
Mikael Berthe <mikael@lilotux.net>
parents:
766
diff
changeset
|
425 #set color_msgout = cyan |
1204
e802ec0c02d2
Basic support for nick highlighting in MUC rooms (the whole line is colored)
Mikael Berthe <mikael@lilotux.net>
parents:
1188
diff
changeset
|
426 #set color_msghl = yellow |
712 | 427 #set color_bgstatus = blue |
428 #set color_status = white | |
2028
7b5bd6ad83b4
Add 'color_log' (text color in the log window)
Mikael Berthe <mikael@lilotux.net>
parents:
2013
diff
changeset
|
429 #set color_log = white |
712 | 430 #set color_roster = green |
431 #set color_bgrostersel = cyan | |
432 #set color_rostersel = blue | |
723
23068490d063
Add text color when the selected buddy has an unread message
Mikael Berthe <mikael@lilotux.net>
parents:
719
diff
changeset
|
433 #set color_rosterselmsg = red |
712 | 434 #set color_rosternewmsg = red |
1960 | 435 #set color_readmark = red |
2090
16b04d64ec88
Add option to highlight timestamp added by server.
Hermitifier
parents:
2070
diff
changeset
|
436 #set color_timestamp = brightblue |
62 | 437 |
1605
79f3b780821a
Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents:
1598
diff
changeset
|
438 # You can color roster items by their status and JID. For example, to have |
1482
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
439 # all roster items white, just all contacts from jabber.org that are away, |
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
440 # not available or do not disturb yellow, you do this: |
1272
033576acac4c
Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1269
diff
changeset
|
441 # |
033576acac4c
Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1269
diff
changeset
|
442 #color roster * * white |
033576acac4c
Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1269
diff
changeset
|
443 #color roster adn *@jabber.org yellow |
033576acac4c
Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents:
1269
diff
changeset
|
444 |
1482
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
445 # You can let mcabber color nicks in MUC. |
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
446 # These colors will by used automatically: |
1293 | 447 #set nick_colors = red green blue |
1482
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
448 # This turns coloring of all mucs on: |
1297
60663a1f9e8d
Better help (unwrapped help file, comment in config)
Michal 'vorner' Vaner <vorner@ucw.cz>
parents:
1293
diff
changeset
|
449 #color muc * on |
1293 | 450 # |
1482
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
451 # If you want someone's nick to be the same all the time: |
1293 | 452 #color mucnick my_friend yellow |
453 | |
511 | 454 # Style |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
455 # Note: the 'log_win_height' and 'roster_width' values below can be set |
702
3e34bd8e073d
Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents:
676
diff
changeset
|
456 # in real time when mcabber is running. Refresh the screen (Ctrl-l) to |
3e34bd8e073d
Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents:
676
diff
changeset
|
457 # use the new values. |
3e34bd8e073d
Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents:
676
diff
changeset
|
458 # |
517
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
459 # Log window height (minimum 1, default 5) |
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
460 #set log_win_height = 5 |
702
3e34bd8e073d
Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents:
676
diff
changeset
|
461 # Buddylist window width (minimum 2, default 24) |
3e34bd8e073d
Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents:
676
diff
changeset
|
462 #set roster_width=24 |
517
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
463 # |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
464 # The options 'log_win_on_top' and 'roster_win_on_right' can change the |
973
e693cbe33802
Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents:
938
diff
changeset
|
465 # position of the log window (top/bottom) and the position of the roster |
e693cbe33802
Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents:
938
diff
changeset
|
466 # (left/right). |
e693cbe33802
Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents:
938
diff
changeset
|
467 #set log_win_on_top = 0 |
e693cbe33802
Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents:
938
diff
changeset
|
468 #set roster_win_on_right = 0 |
e693cbe33802
Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents:
938
diff
changeset
|
469 # |
2100
113d3b96ae3e
Add option 'attention_char'
Mikael Berthe <mikael@lilotux.net>
parents:
2098
diff
changeset
|
470 # The attention sign (default: '!') used when a private message is received |
113d3b96ae3e
Add option 'attention_char'
Mikael Berthe <mikael@lilotux.net>
parents:
2098
diff
changeset
|
471 # can be changed with the 'attention_char' option. |
113d3b96ae3e
Add option 'attention_char'
Mikael Berthe <mikael@lilotux.net>
parents:
2098
diff
changeset
|
472 #set attention_char = ! |
113d3b96ae3e
Add option 'attention_char'
Mikael Berthe <mikael@lilotux.net>
parents:
2098
diff
changeset
|
473 # |
1348
26d1dd2c948f
Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents:
1347
diff
changeset
|
474 # By default, the displayed name of a contact in the roster window will |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
475 # be the JID if no name has been specified. You can use the following |
1348
26d1dd2c948f
Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents:
1347
diff
changeset
|
476 # option if you only want to see the username part. |
26d1dd2c948f
Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents:
1347
diff
changeset
|
477 #set roster_hide_domain = 0 |
26d1dd2c948f
Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents:
1347
diff
changeset
|
478 # |
511 | 479 # Buddy name format (in status window): |
480 # - 0: (default) "<jid/resource>" | |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
481 # - 1: "name <jid/resource>" (name is omitted if same as the JID) |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
482 # - 2: "name/resource" (if the name is the same as the JID, use <jid/res>) |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
483 # - 3: "name" (if the name is the same as the JID, use <jid/res>) |
511 | 484 #set buddy_format = 2 |
517
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
485 # |
1286
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
486 # Time format: |
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
487 # - 0: (default) Date and time |
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
488 # - 1: Time only |
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
489 # - 2: None |
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
490 #set time_prefix = 0 |
02ad6200df26
Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents:
1281
diff
changeset
|
491 # |
1482
f16b280e70d4
Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1472
diff
changeset
|
492 # When a contact sends "/me ", mcabber displays "*user ", where user |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
493 # is the local part of the contact's JID. |
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
494 # If you want mcabber to display the complete bare JID (user@server.com), |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
495 # set 'buddy_me_fulljid' to 1 (default: 0) |
1188
ef40688d87bd
Add option 'buddy_me_fulljid'
Mikael Berthe <mikael@lilotux.net>
parents:
1167
diff
changeset
|
496 #set buddy_me_fulljid = 1 |
ef40688d87bd
Add option 'buddy_me_fulljid'
Mikael Berthe <mikael@lilotux.net>
parents:
1167
diff
changeset
|
497 # |
1450
c6ebf66a4f80
Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1447
diff
changeset
|
498 # Display the status changes in the log window (default: 0, never) |
c6ebf66a4f80
Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1447
diff
changeset
|
499 # Set 'log_display_presence' to 1 to enable. |
c6ebf66a4f80
Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1447
diff
changeset
|
500 #set log_display_presence = 0 |
c6ebf66a4f80
Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents:
1447
diff
changeset
|
501 # |
517
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
502 # Display the status changes in the chat buffers (default: 0, never) |
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
503 # Values: 0: never 1: only connect/disconnect 2: all |
d8f4a0fc77d3
Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
511
diff
changeset
|
504 #set show_status_in_buffer = 1 |
808
4a6ce276ffca
New option "log_display_sender"
Mikael Berthe <mikael@lilotux.net>
parents:
785
diff
changeset
|
505 # |
1610
6db9f403f707
Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1605
diff
changeset
|
506 # Set 'log_display_sender' to 1 to display the message sender's JID in the |
808
4a6ce276ffca
New option "log_display_sender"
Mikael Berthe <mikael@lilotux.net>
parents:
785
diff
changeset
|
507 # log window (default: 0, no) |
4a6ce276ffca
New option "log_display_sender"
Mikael Berthe <mikael@lilotux.net>
parents:
785
diff
changeset
|
508 #set log_display_sender = 0 |
1514 | 509 # |
1530
29c505d43b3e
Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents:
1526
diff
changeset
|
510 # Set 'info' to anything you'd like to see in your lower status line. |
1514 | 511 #set info = woot |
2013
8dc418af3e72
Allow to select to which buddy resource messages go. Closes issue #55
Hermitifier
parents:
2009
diff
changeset
|
512 # |
8dc418af3e72
Allow to select to which buddy resource messages go. Closes issue #55
Hermitifier
parents:
2009
diff
changeset
|
513 # Automatic locking on buddy resource that messages are coming from. |
8dc418af3e72
Allow to select to which buddy resource messages go. Closes issue #55
Hermitifier
parents:
2009
diff
changeset
|
514 # Useful when your buddies are chatting from their non-highest priority |
8dc418af3e72
Allow to select to which buddy resource messages go. Closes issue #55
Hermitifier
parents:
2009
diff
changeset
|
515 # resources, forcing you to use /say_to command. |
8dc418af3e72
Allow to select to which buddy resource messages go. Closes issue #55
Hermitifier
parents:
2009
diff
changeset
|
516 #set roster_autolock_resource = 1 |
2098
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
517 # |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
518 # Automatic locking of buffer when scrolled up, and unlocking when scrolled |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
519 # to bottom. |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
520 # Set 'buffer_smart_scrolling' to 1 to enable. |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
521 # Note: manual command "/buffer scroll_lock" will not work when smart scrolling |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
522 # is enabled. Command "/buffer scroll_unlock" will only work if there is a new |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
523 # message received. |
c4a68361883f
Lock buffer automatically when scrolled up, unlock when at bottom ("buffer_smart_scrolling" setting)
Hermitifier
parents:
2090
diff
changeset
|
524 #set buffer_smart_scrolling = 0 |
511 | 525 |
1068
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
526 # Contacts PGP information |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
527 # You can provide a PGP key to be used for a given Jabber user, or |
1110 | 528 # disable PGP on a per-account basis. |
1068
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
529 # If you provide a KeyId for a contact, it will be compared to the key the |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
530 # contact uses to sign their presence/messages and it will be used for |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
531 # all outgoing encrypted messages (that is, the contact signature key will |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
532 # be ignored). |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
533 # Please note that the key must match exactly the id seen with /info. |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
534 #pgp disable foo@bar.org |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
535 #pgp setkey bar@foo.net C9940A9BB0B92210 |
6646d2ed7f74
Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1042
diff
changeset
|
536 |
1347
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
537 # OTR (Off-The-Record messaging) support |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
538 # (Only available if mcabber is built with OTR support) |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
539 # Set otr to 1 to enable OTR support. |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
540 # You cannot change this option once mcabber is running. |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
541 #set otr = 0 |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
542 # |
1320 | 543 # OTR directory |
1347
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
544 # You can specify the OTR directory with the otr_dir option |
07816313073b
Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents:
1320
diff
changeset
|
545 # (default = ~/.mcabber/otr/). |
1320 | 546 #set otr_dir = "~/.mcabber/otr/" |
1557
31422cb73356
Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1549
diff
changeset
|
547 # |
31422cb73356
Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1549
diff
changeset
|
548 # You can set OTR policies from the configuration file (use /help otrpolicy |
31422cb73356
Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1549
diff
changeset
|
549 # for the details). |
31422cb73356
Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents:
1549
diff
changeset
|
550 #otrpolicy default manual |
1320 | 551 |
2000 | 552 # Entity Caps cache |
553 # You can provide a directory where mcabber will store an offline cache | |
554 # of other clients' capabilities. This will likely reduce network overhead | |
555 # on start of new session. | |
556 #set caps_directory = "~/.mcabber/caps" | |
557 | |
511 | 558 # Aliases |
550 | 559 alias me = say /me |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
560 alias online = status online |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
561 alias away = status away |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
562 alias dnd = status dnd |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
563 alias notavail = status notavail |
530 | 564 #alias names = room names |
1269
6495aa83d059
Small changes to the sample config file (suggested by bb)
Mikael Berthe <mikael@lilotux.net>
parents:
1268
diff
changeset
|
565 #alias topic = room topic |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
566 |
1563 | 567 # Set use_mouse to 1 to map mouse buttons like keycodes. |
568 #set use_mouse = 1 | |
569 | |
511 | 570 # Key bindings |
1585
da6a359c8a03
Fix typo reported in issue #34
Mikael Berthe <mikael@lilotux.net>
parents:
1563
diff
changeset
|
571 # Ctrl-q (17) bound to /roster unread_next |
1131
73e6ca0a03a9
Un-hardcode Ctrl-q binding, it can be done in the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
1129
diff
changeset
|
572 bind 17 = roster unread_next |
1585
da6a359c8a03
Fix typo reported in issue #34
Mikael Berthe <mikael@lilotux.net>
parents:
1563
diff
changeset
|
573 # Ctrl-x (24) bound to /roster alternate |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
574 bind 24 = roster alternate |
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
575 # 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
|
576 bind 269 = roster toggle_offline |
719 | 577 # F12 (276) bound to /roster toggle |
578 bind 276 = roster toggle | |
766
c71ff9ade18c
Move Ctrl-Up/Down bindings to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
739
diff
changeset
|
579 # Ctrl-Up/Ctrl-Down bound to /buffer up/down (like Ctrl-p/Ctrl-n) |
c71ff9ade18c
Move Ctrl-Up/Down bindings to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
739
diff
changeset
|
580 bind 521 = buffer up |
c71ff9ade18c
Move Ctrl-Up/Down bindings to the config. file
Mikael Berthe <mikael@lilotux.net>
parents:
739
diff
changeset
|
581 bind 514 = buffer down |
334
475dccabe6f3
New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents:
322
diff
changeset
|
582 |
719 | 583 # Sample alias to join mcabber channel with "/jmc" |
584 #alias jmc = room join mcabber@conf.lilotux.net |