mcabber/mcabberrc.example
author Mikael Berthe <mikael@lilotux.net>
Sun, 11 Oct 2009 20:06:47 +0200
changeset 1610 6db9f403f707
parent 1605 79f3b780821a
child 1616 4c7104ec5f3b
permissions -rw-r--r--
Replace 'username' with 'jid' in the configuration file The previous behaviour doesn't make much sense anymore. MCabber does DNS SRV lookups so providing the server name is usually not needed.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
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
19f57e681252 [/trunk] Changeset 99 by mikael
mikael
parents: 70
diff changeset
    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
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    15
# 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
    16
# to a specific server.
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    17
#set server = your.jabber.server
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    18
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    19
# 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
    20
#set port = 5222
1610
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    21
1441
736b82610dfa mcabberrc: do not set a default resource
Mikael Berthe <mikael@lilotux.net>
parents: 1437
diff changeset
    22
# 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
    23
# 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
    24
# suffix to the resource name.
1441
736b82610dfa mcabberrc: do not set a default resource
Mikael Berthe <mikael@lilotux.net>
parents: 1437
diff changeset
    25
#set resource = mcabber
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
    26
#set disable_random_resource = 0
1610
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    27
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
    28
#set priority = 3
1419
fb438482b28e New option to customize the away/notavail priority (Michael Gehring)
Mikael Berthe <mikael@lilotux.net>
parents: 1417
diff changeset
    29
#set priority_away = 0
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
    30
1446
49c8be874344 Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1444
diff changeset
    31
# 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
    32
# presence in your roster (default: 0).
49c8be874344 Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1444
diff changeset
    33
set ignore_self_presence = 1
49c8be874344 Add option 'ignore_self_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1444
diff changeset
    34
1598
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    35
# SSL/TLS options:
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    36
# 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
    37
# You can require TLS by setting tls to 1.  If your jabber server
1598
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    38
# 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
    39
# 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
    40
#set ssl = 0
1598
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    41
set tls = 1
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    42
# Moreover, it's possible to check whether the fingerprint of the
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    43
# ssl certificate matches ssl_fingerprint.
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    44
# You can get the fingerprint of your server either with gnutls or openssl:
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    45
# 1. gnutls-cli -p 5223 $your_server
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    46
# 2. openssl s_client -connect $your_server:5223 | \
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    47
#    openssl x509 -fingerprint -md5 -noout
1610
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
    48
#set ssl_fingerprint = 97:5C:00:3F:1D:77:45:25:E2:C5:70:EC:83:C8:87:EE
1598
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    49
# Set ssl_ignore_checks to 1 to disable all certificate checks except the
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    50
# fingerprint check.
a087125d8fc8 Replace libjabber with loudmouth
franky
parents: 1590
diff changeset
    51
#set ssl_ignore_checks = 0
938
40175f3dcef7 SSL server certificate verification
Jefferson Ogata <ogata@antibozo.net>
parents: 919
diff changeset
    52
1042
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    53
# PGP support
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    54
# Set pgp to 1 to enable OpenPGP.
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    55
# To sign outgoing messages, select your private key id with
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    56
# 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
    57
# mcabber is running.
1068
6646d2ed7f74 Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1042
diff changeset
    58
# 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
    59
#set pgp = 0
1068
6646d2ed7f74 Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1042
diff changeset
    60
#set pgp_private_key = "C9940A9BB0B92210"
1042
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    61
#
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    62
# 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
    63
#set pgp_passphrase = "PGPpassword"
1313
d1d12a09b04a Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents: 1311
diff changeset
    64
#
d1d12a09b04a Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents: 1311
diff changeset
    65
# 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
    66
# 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
    67
# until the passphrase is good.
d1d12a09b04a Make passphrase entry retries customizable (suggested by Till Maas)
Mikael Berthe <mikael@lilotux.net>
parents: 1311
diff changeset
    68
#pgp_passphrase_retries = 2
1042
8a395c2cafc4 Initial PGP support (decrypt)
Mikael Berthe <mikael@lilotux.net>
parents: 993
diff changeset
    69
659
e61aa455c61b MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents: 635
diff changeset
    70
# Conference nickname
e61aa455c61b MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents: 635
diff changeset
    71
# 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
    72
# 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
    73
# the jid variable can be used.
659
e61aa455c61b MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents: 635
diff changeset
    74
#set nickname = Abitbol
e61aa455c61b MUC: Add "nickname" option variable
Mikael Berthe <mikael@lilotux.net>
parents: 635
diff changeset
    75
429
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    76
# Proxy
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    77
# mcabber can use a proxy if it supports the CONNECT method
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    78
# The proxy_user/proxy_pass variables are optional.
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    79
#set proxy_host = "proxy-hostname"
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    80
#set proxy_port = 3128
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    81
#set proxy_user = "username"
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    82
#set proxy_pass = "password"
0bb3d37579aa Enable proxy support
Mikael Berthe <mikael@lilotux.net>
parents: 405
diff changeset
    83
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
    84
# Keepalive
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
    85
# If you need a ping/keepalive to leave your connection open, you
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
    86
# can use the pinginterval.  Setting this option to 0 disables the ping.
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
    87
# Default value is 40 seconds.
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
    88
#set pinginterval = 40
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
    89
919
653c1cdfb589 Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents: 899
diff changeset
    90
# Language
653c1cdfb589 Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents: 899
diff changeset
    91
# Help files have been translated into a few languages.
1098
b3bfdecfd178 Add "de" to the Makefile & config file. Fix some typos.
Mikael Berthe <mikael@lilotux.net>
parents: 1068
diff changeset
    92
# You can set lang to one of the following values: en (default),
1549
e7435238e963 New Czech translation (Vic)
Mikael Berthe <mikael@lilotux.net>
parents: 1530
diff changeset
    93
# cs, de, fr, it, nl, pl, ru, uk.
919
653c1cdfb589 Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents: 899
diff changeset
    94
#set lang = en
653c1cdfb589 Mention the "lang" variable
Mikael Berthe <mikael@lilotux.net>
parents: 899
diff changeset
    95
1206
abc5847d1613 Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents: 1204
diff changeset
    96
# Aspell
abc5847d1613 Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents: 1204
diff changeset
    97
# 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
    98
# 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
    99
# running).
1590
8d1bcc83ae32 Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents: 1585
diff changeset
   100
#set spell_enable = 1
8d1bcc83ae32 Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents: 1585
diff changeset
   101
#set spell_lang = en_US
8d1bcc83ae32 Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents: 1585
diff changeset
   102
#set spell_encoding = iso8859-1
8d1bcc83ae32 Add support for spellchecking with Enchant (caolan)
Mikael Berthe <mikael@lilotux.net>
parents: 1585
diff changeset
   103
#set spell_encoding = UTF-8
1206
abc5847d1613 Add Aspell options to the config. file
Mikael Berthe <mikael@lilotux.net>
parents: 1204
diff changeset
   104
1127
fddf2fef7b83 Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents: 1120
diff changeset
   105
# History
fddf2fef7b83 Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents: 1120
diff changeset
   106
# Number of lines to remember for the command line history
fddf2fef7b83 Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents: 1120
diff changeset
   107
# (default: 0, unlimited).
fddf2fef7b83 Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents: 1120
diff changeset
   108
set cmdhistory_lines = 250
fddf2fef7b83 Add option "cmdhistory_lines"
Mikael Berthe <mikael@lilotux.net>
parents: 1120
diff changeset
   109
1311
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   110
# 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
   111
# their status.  The mask should contain the shortcut letters of the
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   112
# 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
   113
# [n]ot_available, [a]way, [_]offline).
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   114
# For example, to display everybody the filter should be "ofdna_" (default).
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   115
# To display only the connected buddies, use "ofdna".
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   116
# 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
   117
# running you can use "/roster display").
1311
0dda8238af21 Implement "/roster display"
Mikael Berthe <mikael@lilotux.net>
parents: 1297
diff changeset
   118
#set roster_display_filter = ofdna_
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
   119
993
0759f4c7da68 Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents: 983
diff changeset
   120
# Typing notifications, Chat States, Events (JEP-22/85)
0759f4c7da68 Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents: 983
diff changeset
   121
# 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
   122
# 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
   123
#set disable_chatstates = 0
0759f4c7da68 Add option 'disable_chatstates'
Mikael Berthe <mikael@lilotux.net>
parents: 983
diff changeset
   124
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
   125
# History logging
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
   126
# 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
   127
# 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
   128
# (and status messages) to the log files (default: 0).
177
a51ce78a0e2a [/trunk] Changeset 189 by mikael
mikael
parents: 169
diff changeset
   129
# 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
   130
# If you enable load_logs, you can use the 'max_history_age' setting below.
169
0ed6099b5a54 [/trunk] Changeset 181 by mikael
mikael
parents: 162
diff changeset
   131
# 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
   132
# Defaults for logging, load_logs are 0 (disabled)
376
d37d8d661115 Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents: 374
diff changeset
   133
# Note: the logging directory must exist if you enable logging, mcabber
d37d8d661115 Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents: 374
diff changeset
   134
#       will not create it.
1141
5be2408a6534 Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents: 1136
diff changeset
   135
# 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
   136
# 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
   137
#set logging = 1
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   138
#set load_logs = 1
1167
9726c78a91f3 Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents: 1166
diff changeset
   139
#set logging_dir = ~/.mcabber/histo/
1144
b8f5fe2d666a Add option "logging_ignore_status"
Mikael Berthe <mikael@lilotux.net>
parents: 1141
diff changeset
   140
#set logging_ignore_status = 1
160
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
   141
477
d11e5ce2582c Improve hk_message_in()
Mikael Berthe <mikael@lilotux.net>
parents: 453
diff changeset
   142
# 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
   143
#set log_muc_conf = 1
d4119cb85aeb New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents: 619
diff changeset
   144
# 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
   145
# 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
   146
# from the server.
d4119cb85aeb New "load_muc_logs" option
Mikael Berthe <mikael@lilotux.net>
parents: 619
diff changeset
   147
#set load_muc_logs = 0
477
d11e5ce2582c Improve hk_message_in()
Mikael Berthe <mikael@lilotux.net>
parents: 453
diff changeset
   148
899
a833f3d6119a Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents: 837
diff changeset
   149
# 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
   150
# 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
   151
# Default = 0 (disabled -- everything is loaded)
a833f3d6119a Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents: 837
diff changeset
   152
# 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
   153
#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
   154
071c8170b7de Add option 'statefile' to keep track of unread messages across restarts
Mikael Berthe <mikael@lilotux.net>
parents: 1427
diff changeset
   155
# 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
   156
# 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
   157
# 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
   158
#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
   159
1141
5be2408a6534 Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents: 1136
diff changeset
   160
# 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
   161
# about 8kB).  The default is 0 (unlimited).  If set, this value must be > 2.
5be2408a6534 Add option "max_history_blocks"
Mikael Berthe <mikael@lilotux.net>
parents: 1136
diff changeset
   162
#set max_history_blocks = 8
899
a833f3d6119a Add option 'max_history_age'
Mikael Berthe <mikael@lilotux.net>
parents: 837
diff changeset
   163
619
44ddf9bec3a5 Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents: 550
diff changeset
   164
# IQ settings
44ddf9bec3a5 Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents: 550
diff changeset
   165
# 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
   166
# your OS version.
619
44ddf9bec3a5 Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents: 550
diff changeset
   167
#set iq_version_hide_os = 0
1254
401639413340 More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents: 1207
diff changeset
   168
#
401639413340 More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents: 1207
diff changeset
   169
# 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
   170
# 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
   171
# 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
   172
# (Default is 0 for both options)
1254
401639413340 More jabber:iq:last support... (misc)
Mikael Berthe <mikael@lilotux.net>
parents: 1207
diff changeset
   173
#set iq_last_disable = 0
1263
d1a111f39b7a Fix typo in mcabberrc sample file
Mikael Berthe <mikael@lilotux.net>
parents: 1261
diff changeset
   174
#set iq_last_disable_when_notavail = 1
1498
2eaa52d314e3 Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents: 1496
diff changeset
   175
#
2eaa52d314e3 Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents: 1496
diff changeset
   176
# 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
   177
# displayed in the status window (default: 0).
2eaa52d314e3 Add option 'iq_hide_requests'
Mikael Berthe <mikael@lilotux.net>
parents: 1496
diff changeset
   178
#set iq_hide_requests = 1
619
44ddf9bec3a5 Answer IQ:version & IQ:time requests
Mikael Berthe <mikael@lilotux.net>
parents: 550
diff changeset
   179
675
ae7016aae014 New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents: 659
diff changeset
   180
# Beep
ae7016aae014 New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents: 659
diff changeset
   181
# 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
   182
# 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
   183
# 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
   184
#set beep_on_message = 0
ae7016aae014 New "beep_on_message" option
Mikael Berthe <mikael@lilotux.net>
parents: 659
diff changeset
   185
160
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
   186
# External command for events
44c6410b4845 [/trunk] Changeset 172 by mikael
mikael
parents: 139
diff changeset
   187
# 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
   188
# 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
   189
# 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
   190
#
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   191
# 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
   192
# 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
   193
# 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
   194
# 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
   195
# 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
   196
# 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
   197
#
355
c5a7a7273986 Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents: 339
diff changeset
   198
# The command is called the following way:
525
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   199
#   $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
   200
#   $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
   201
#   $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
   202
#   $events_command STATUS X jabber@id      (new buddy status is X)
1444
3bf11085c6a5 New external "UNREAD" event (suggested by Viacheslav Chumushuk)
Mikael Berthe <mikael@lilotux.net>
parents: 1441
diff changeset
   203
#   $events_command UNREAD N                (number of unread buddy buffers)
355
c5a7a7273986 Add some external actions
Mikael Berthe <mikael@lilotux.net>
parents: 339
diff changeset
   204
# See sample script in contrib/ directory.
1167
9726c78a91f3 Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents: 1166
diff changeset
   205
#set events_command = ~/.mcabber/eventcmd
525
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   206
#
1129
1a109ebf3f24 Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents: 1127
diff changeset
   207
#set events_ignore_active_window = 0
1a109ebf3f24 Add option "events_ignore_active_window"
Mikael Berthe <mikael@lilotux.net>
parents: 1127
diff changeset
   208
#
525
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   209
#set event_log_files = 0
1167
9726c78a91f3 Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents: 1166
diff changeset
   210
#set event_log_dir = ~/.mcabber/event_files
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
   211
1447
ba706e97d6ec Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents: 1446
diff changeset
   212
# 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
   213
# (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
   214
#set eventcmd_use_nickname = 0
ba706e97d6ec Add option 'eventcmd_use_nickname'
Mikael Berthe <mikael@lilotux.net>
parents: 1446
diff changeset
   215
676
80d4959422ca New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents: 675
diff changeset
   216
# External command status check
80d4959422ca New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents: 675
diff changeset
   217
# 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
   218
# 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
   219
# exit value is 2.
80d4959422ca New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents: 675
diff changeset
   220
#set eventcmd_checkstatus = 0
80d4959422ca New "eventcmd_checkstatus" option
Mikael Berthe <mikael@lilotux.net>
parents: 675
diff changeset
   221
1353
7caedca15e50 Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1348
diff changeset
   222
# Internal hooks
7caedca15e50 Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1348
diff changeset
   223
# 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
   224
# occurs (for example when it connects to the server).
7caedca15e50 Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1348
diff changeset
   225
#
7caedca15e50 Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1348
diff changeset
   226
# '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
   227
# and the roster has been received.
7caedca15e50 Add post-connect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1348
diff changeset
   228
#set hook-post-connect = status dnd
1354
c373ff3fe7e1 Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1353
diff changeset
   229
#
c373ff3fe7e1 Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1353
diff changeset
   230
# '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
   231
# the server.
c373ff3fe7e1 Add pre-disconnect internal hook
Mikael Berthe <mikael@lilotux.net>
parents: 1353
diff changeset
   232
#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
   233
1426
a64778f5f26b Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents: 1419
diff changeset
   234
# FIFO
a64778f5f26b Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents: 1419
diff changeset
   235
# mcabber can create a FIFO named pipe and listen to this pipe for commands.
1490
9d5a2f45addb Remove obsolete note in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1482
diff changeset
   236
# Default: disabled.
1526
eefa0ae248d8 Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents: 1520
diff changeset
   237
# 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
   238
# 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
   239
# 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
   240
# 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
   241
# still read but it is discarded.
1426
a64778f5f26b Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents: 1419
diff changeset
   242
#set fifo_name = ~/.mcabber/mcabber.fifo
1427
a8eb9aba2ed2 Add option 'fifo_hide_commands'
Mikael Berthe <mikael@lilotux.net>
parents: 1426
diff changeset
   243
#set fifo_hide_commands = 0
1526
eefa0ae248d8 Add option "fifo_ignore" (Suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents: 1520
diff changeset
   244
#set fifo_ignore = 0
1426
a64778f5f26b Implement FIFO named command pipe
Mikael Berthe <mikael@lilotux.net>
parents: 1419
diff changeset
   245
374
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   246
# Traces logging
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   247
# If you want advanced traces, please specify a file and a level here.
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   248
# There are currently 2 traceloglog levels:
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   249
#  lvl 1: most events of the log window are written to the file
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   250
#  lvl 2: debug logging (XML, etc.)
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   251
# Default is level 0, no trace logging
bd5638c21834 Improve logging system (traces)
Mikael Berthe <mikael@lilotux.net>
parents: 364
diff changeset
   252
#set tracelog_level = 1
1167
9726c78a91f3 Allow '~' (HOME directory) in config options
Mikael Berthe <mikael@lilotux.net>
parents: 1166
diff changeset
   253
#set tracelog_file = ~/.mcabber/mcabber.log
113
8ac67e951eab [/trunk] Changeset 127 by mikael
mikael
parents: 87
diff changeset
   254
525
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   255
# 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
   256
# 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
   257
# (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
   258
# 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
   259
# See 'message_autoaway' below.
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   260
#set autoaway = 0
c7f94f6e51f0 Update sample mcabberrc and eventcmd script
Mikael Berthe <mikael@lilotux.net>
parents: 522
diff changeset
   261
819
c2d7d9dd4193 New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents: 808
diff changeset
   262
# Message blocking
823
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   263
# 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
   264
# messages from people you haven't authorized. (default: 0)
c2d7d9dd4193 New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents: 808
diff changeset
   265
#set block_unsubscribed = 0
823
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   266
#
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   267
# 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
   268
# roster when you reject their subscription request. (default: 0)
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   269
# (See documentation for /event)
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   270
# 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
   271
# 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
   272
# won't be deleted.
19c615fd071e New option "delete_on_reject"
Mikael Berthe <mikael@lilotux.net>
parents: 819
diff changeset
   273
#set delete_on_reject = 0
819
c2d7d9dd4193 New option 'block_unsubscribed'
Mikael Berthe <mikael@lilotux.net>
parents: 808
diff changeset
   274
837
7c74eef1d0e0 New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents: 823
diff changeset
   275
# MUC
1166
c4da23bf8958 Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents: 1144
diff changeset
   276
# 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
   277
# 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
   278
# for leaves too.
c4da23bf8958 Add option 'muc_flag_joins'
Mikael Berthe <mikael@lilotux.net>
parents: 1144
diff changeset
   279
#set muc_flag_joins = 0
1377
cd9182f0b5c7 Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents: 1354
diff changeset
   280
# 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
   281
# 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
   282
# 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
   283
# 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
   284
# (default: in_and_out)
cd9182f0b5c7 Add /room setopt {print_status,auto_whois}
Mikael Berthe <mikael@lilotux.net>
parents: 1354
diff changeset
   285
#set muc_print_status = 2
837
7c74eef1d0e0 New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents: 823
diff changeset
   286
# 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
   287
# somebody joins a room. (default: 0)
7c74eef1d0e0 New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents: 823
diff changeset
   288
#set muc_auto_whois = 0
1207
8f0af3b88cef MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents: 1206
diff changeset
   289
#
8f0af3b88cef MUC: improve nickname detection and add option 'muc_disable_nick_hl'
Mikael Berthe <mikael@lilotux.net>
parents: 1206
diff changeset
   290
# 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
   291
# 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
   292
#set muc_disable_nick_hl = 0
837
7c74eef1d0e0 New option "muc_auto_whois"
Mikael Berthe <mikael@lilotux.net>
parents: 823
diff changeset
   293
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   294
# Status messages
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   295
# 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
   296
#set message = Unique message status
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   297
#set message_avail     = I'm available
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   298
#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
   299
#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
   300
#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
   301
#set message_away      = I'm away
522
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 517
diff changeset
   302
#
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 517
diff changeset
   303
# The auto-away message is only used when 'autoaway' is set.  The previous
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 517
diff changeset
   304
# message will be restored when leaving auto-away status.  If this message
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 517
diff changeset
   305
# isn't defined, the status message will stay unchanged.
530
365e1ded7f1a Suggest "names" alias
Mikael Berthe <mikael@lilotux.net>
parents: 525
diff changeset
   306
set message_autoaway = Auto-away (idle)
294
871e53769084 Allow one status message per Jabber status
Mikael Berthe <mikael@lilotux.net>
parents: 272
diff changeset
   307
1386
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   308
# Escape timeout delay (ESCDELAY)
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   309
# The ESCDELAY variable specifies the time, in milliseconds, for which
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   310
# the ncurses interface will await a character sequence.
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   311
# The default is 1000 (1 second).
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   312
# If you want mcabber to react faster after hitting Escape, you can lower
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   313
# this value by setting the ESCDELAY environment variable or setting the
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   314
# 'escdelay' option.
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   315
set escdelay = 50
8e763c2c331f Add option 'escdelay'
Mikael Berthe <mikael@lilotux.net>
parents: 1377
diff changeset
   316
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   317
# Colors
267
8d3d5bd52da3 Improve color configuration
mikael@frmp8452
parents: 232
diff changeset
   318
# 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
   319
# 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
   320
# 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
   321
# 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
   322
# 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
   323
# directly (16-255).
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   324
#
1417
783b47c9d963 Allow more than the 16 default colors (patch from mjs)
Mikael Berthe <mikael@lilotux.net>
parents: 1386
diff changeset
   325
# 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
   326
# color settings.
0d5fb1d9077c Allow "bright" text colors
Mikael Berthe <mikael@lilotux.net>
parents: 736
diff changeset
   327
#
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   328
# background: background color of the chat window and the log window
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   329
# 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
   330
# 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
   331
# 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
   332
# 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
   333
# msghl:      text color in the chat window for highlighted messages (MUC)
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   334
# bgstatus:   background color of the status lines
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   335
# status:     text color of the status lines
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   336
# roster:     text color of the roster (buddylist) normal items
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   337
# bgrostersel: background color of the selected roster item
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   338
# 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
   339
# rosterselmsg:text color of the selected roster item, if there is a new msg
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   340
# rosternewmsg: text color of items with unread messages
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   341
#
736
a8fa82e611c3 Change default background color in the sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 731
diff changeset
   342
#set color_background   = black
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   343
#set color_general      = white
1281
b1be0c6862d4 Minor conffile changes
Mikael Berthe <mikael@lilotux.net>
parents: 1272
diff changeset
   344
#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
   345
#set color_msgin        = white
785
7e0562e3bc83 Replace color_highlight with color_msgout
Mikael Berthe <mikael@lilotux.net>
parents: 766
diff changeset
   346
#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
   347
#set color_msghl        = yellow
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   348
#set color_bgstatus     = blue
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   349
#set color_status       = white
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   350
#set color_roster       = green
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   351
#set color_bgrostersel  = cyan
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   352
#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
   353
#set color_rosterselmsg = red
712
e1639629c87b Rename color options
Mikael Berthe <mikael@lilotux.net>
parents: 702
diff changeset
   354
#set color_rosternewmsg = red
62
db2a1826bafa [/trunk] Changeset 77 by mikael
mikael
parents:
diff changeset
   355
1605
79f3b780821a Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents: 1598
diff changeset
   356
# 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
   357
# 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
   358
# 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
   359
#
033576acac4c Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents: 1269
diff changeset
   360
#color roster * * white
033576acac4c Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents: 1269
diff changeset
   361
#color roster adn *@jabber.org yellow
033576acac4c Add configurable roster colors (Michal 'vorner' Vaner)
Mikael Berthe <mikael@lilotux.net>
parents: 1269
diff changeset
   362
1482
f16b280e70d4 Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1472
diff changeset
   363
# 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
   364
# These colors will by used automatically:
1293
359e1c53552a Coloring help
Michal 'vorner' Vaner <vorner@ucw.cz>
parents: 1286
diff changeset
   365
#set nick_colors = red green blue
1482
f16b280e70d4 Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1472
diff changeset
   366
# 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
   367
#color muc * on
1293
359e1c53552a Coloring help
Michal 'vorner' Vaner <vorner@ucw.cz>
parents: 1286
diff changeset
   368
#
1482
f16b280e70d4 Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1472
diff changeset
   369
# If you want someone's nick to be the same all the time:
1293
359e1c53552a Coloring help
Michal 'vorner' Vaner <vorner@ucw.cz>
parents: 1286
diff changeset
   370
#color mucnick my_friend yellow
359e1c53552a Coloring help
Michal 'vorner' Vaner <vorner@ucw.cz>
parents: 1286
diff changeset
   371
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   372
# Style
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   373
# 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
   374
# 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
   375
# use the new values.
3e34bd8e073d Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents: 676
diff changeset
   376
#
517
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   377
# Log window height (minimum 1, default 5)
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   378
#set log_win_height = 5
702
3e34bd8e073d Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents: 676
diff changeset
   379
# Buddylist window width (minimum 2, default 24)
3e34bd8e073d Update sample configuration file (roster_width option)
Mikael Berthe <mikael@lilotux.net>
parents: 676
diff changeset
   380
#set roster_width=24
517
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   381
#
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   382
# 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
   383
# 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
   384
# (left/right).
e693cbe33802 Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents: 938
diff changeset
   385
#set log_win_on_top = 0
e693cbe33802 Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents: 938
diff changeset
   386
#set roster_win_on_right = 0
e693cbe33802 Add option 'roster_win_on_right'
Mikael Berthe <mikael@lilotux.net>
parents: 938
diff changeset
   387
#
1348
26d1dd2c948f Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents: 1347
diff changeset
   388
# 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
   389
# 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
   390
# 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
   391
#set roster_hide_domain = 0
26d1dd2c948f Add option 'roster_hide_domain'
Mikael Berthe <mikael@lilotux.net>
parents: 1347
diff changeset
   392
#
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   393
# Buddy name format (in status window):
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   394
# - 0: (default) "<jid/resource>"
1610
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
   395
# - 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
   396
# - 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
   397
# - 3: "name" (if the name is the same as the JID, use <jid/res>)
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   398
#set buddy_format = 2
517
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   399
#
1286
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   400
# Time format:
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   401
# - 0: (default) Date and time
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   402
# - 1: Time only
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   403
# - 2: None
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   404
#set time_prefix = 0
02ad6200df26 Add selectable time prefixes (vorner)
Mikael Berthe <mikael@lilotux.net>
parents: 1281
diff changeset
   405
#
1482
f16b280e70d4 Minor updates to the sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1472
diff changeset
   406
# 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
   407
# 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
   408
# 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
   409
# set 'buddy_me_fulljid' to 1 (default: 0)
1188
ef40688d87bd Add option 'buddy_me_fulljid'
Mikael Berthe <mikael@lilotux.net>
parents: 1167
diff changeset
   410
#set buddy_me_fulljid = 1
ef40688d87bd Add option 'buddy_me_fulljid'
Mikael Berthe <mikael@lilotux.net>
parents: 1167
diff changeset
   411
#
1450
c6ebf66a4f80 Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1447
diff changeset
   412
# 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
   413
# Set 'log_display_presence' to 1 to enable.
c6ebf66a4f80 Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1447
diff changeset
   414
#set log_display_presence = 0
c6ebf66a4f80 Add option 'log_display_presence'
Mikael Berthe <mikael@lilotux.net>
parents: 1447
diff changeset
   415
#
517
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   416
# 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
   417
# Values:  0: never  1: only connect/disconnect  2: all
d8f4a0fc77d3 Update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
   418
#set show_status_in_buffer = 1
808
4a6ce276ffca New option "log_display_sender"
Mikael Berthe <mikael@lilotux.net>
parents: 785
diff changeset
   419
#
1610
6db9f403f707 Replace 'username' with 'jid' in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1605
diff changeset
   420
# 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
   421
# log window (default: 0, no)
4a6ce276ffca New option "log_display_sender"
Mikael Berthe <mikael@lilotux.net>
parents: 785
diff changeset
   422
#set log_display_sender = 0
1514
939e2957f8a8 Add option "info" (suggested by lego)
franky@diable
parents: 1498
diff changeset
   423
#
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   424
# Set 'info' to anything you'd like to see in your lower status line.
1514
939e2957f8a8 Add option "info" (suggested by lego)
franky@diable
parents: 1498
diff changeset
   425
#set info = woot
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   426
#
1605
79f3b780821a Update mcabberrc.example
Mikael Berthe <mikael@lilotux.net>
parents: 1598
diff changeset
   427
# Set 'url_regex' to a regular expression matching urls.  If it matches an
1530
29c505d43b3e Use random resource suffix by default
Mikael Berthe <mikael@lilotux.net>
parents: 1526
diff changeset
   428
# url in an incoming messages, it'll print it to the log window.
1520
41d3457af815 Add option "url_regex"
franky@diable.fs
parents: 1514
diff changeset
   429
#set url_regex = "(((https?|ftps?|nntp)://)|www[.][-a-z0-9.]+|(mailto:|news:))(%[0-9A-F]{2}|[-_.!~*';/?:@&=+$,#[:alnum:]])+"
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   430
1068
6646d2ed7f74 Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1042
diff changeset
   431
# Contacts PGP information
6646d2ed7f74 Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1042
diff changeset
   432
# You can provide a PGP key to be used for a given Jabber user, or
1110
6db427a14ee8 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1101
diff changeset
   433
# 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
   434
# 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
   435
# 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
   436
# 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
   437
# be ignored).
6646d2ed7f74 Allow pgp commands in config file, update sample configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1042
diff changeset
   438
# 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
   439
#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
   440
#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
   441
1347
07816313073b Add an option 'otr' to enable OTR support in the configuration file
Mikael Berthe <mikael@lilotux.net>
parents: 1320
diff changeset
   442
# 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
   443
# (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
   444
# 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
   445
# 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
   446
#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
   447
#
1320
cb400799db8f Configurable OTR directory
franky@veqlargh.fs
parents: 1318
diff changeset
   448
# 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
   449
# 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
   450
# (default = ~/.mcabber/otr/).
1320
cb400799db8f Configurable OTR directory
franky@veqlargh.fs
parents: 1318
diff changeset
   451
#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
   452
#
31422cb73356 Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents: 1549
diff changeset
   453
# 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
   454
# for the details).
31422cb73356 Mention otrpolicy in the sample configuration file (suggested by T. Glaser)
Mikael Berthe <mikael@lilotux.net>
parents: 1549
diff changeset
   455
#otrpolicy default manual
1320
cb400799db8f Configurable OTR directory
franky@veqlargh.fs
parents: 1318
diff changeset
   456
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   457
# Aliases
550
89cc86940f09 Add an alias for "/me"
Mikael Berthe <mikael@lilotux.net>
parents: 530
diff changeset
   458
alias me = say /me
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   459
alias online   = status online
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   460
alias away     = status away
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   461
alias dnd      = status dnd
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   462
alias notavail = status notavail
530
365e1ded7f1a Suggest "names" alias
Mikael Berthe <mikael@lilotux.net>
parents: 525
diff changeset
   463
#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
   464
#alias topic = room topic
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   465
1563
c1d0f906d379 Add option "use_mouse"
franky
parents: 1557
diff changeset
   466
# Set use_mouse to 1 to map mouse buttons like keycodes.
c1d0f906d379 Add option "use_mouse"
franky
parents: 1557
diff changeset
   467
#set use_mouse = 1
c1d0f906d379 Add option "use_mouse"
franky
parents: 1557
diff changeset
   468
511
c7cdb9c6d7aa Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 500
diff changeset
   469
# Key bindings
1585
da6a359c8a03 Fix typo reported in issue #34
Mikael Berthe <mikael@lilotux.net>
parents: 1563
diff changeset
   470
# 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
   471
bind 17 = roster unread_next
1585
da6a359c8a03 Fix typo reported in issue #34
Mikael Berthe <mikael@lilotux.net>
parents: 1563
diff changeset
   472
# 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
   473
bind 24 = roster alternate
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   474
# 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
   475
bind 269 = roster toggle_offline
719
241c9128766a Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 712
diff changeset
   476
# F12 (276) bound to /roster toggle
241c9128766a Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 712
diff changeset
   477
bind 276 = roster toggle
766
c71ff9ade18c Move Ctrl-Up/Down bindings to the config. file
Mikael Berthe <mikael@lilotux.net>
parents: 739
diff changeset
   478
# 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
   479
bind 521 = buffer up
c71ff9ade18c Move Ctrl-Up/Down bindings to the config. file
Mikael Berthe <mikael@lilotux.net>
parents: 739
diff changeset
   480
bind 514 = buffer down
334
475dccabe6f3 New config. file parsing -- update sample config. file
Mikael Berthe <mikael@lilotux.net>
parents: 322
diff changeset
   481
719
241c9128766a Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 712
diff changeset
   482
# Sample alias to join mcabber channel with "/jmc"
241c9128766a Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 712
diff changeset
   483
#alias jmc = room join mcabber@conf.lilotux.net