# Sample ~/.mcabber/mcabberrc file# Note about this file syntax:# - Leading and trailing spaces are ignored.# - Empty lines and lines beginning with a '#' are ignored.# Please provide your Jabber (XMPP) identifier:setjid = yourusername@domain# If password is not given, it will be interactively asked for.# Note: if the password contains leading or trailing spaces, you must# enclose it with quotes: set password = " example password "#set password = yourpassword# Read password from output of the given command.# This is a way to use password managers like 'pass' in order# to avoid writing plain passwords into config files.#set password_eval = "your command"# You can provide a server name if you want mcabber to connect# to a specific server.#set server = your.jabber.server# To automatically append the server to the JID in say_to, use this option:#set default_server = jabber.org# If port is not given, mcabber will try to find it out.#set port = 5222# If you don't know what a resource is, do not set it.# Set disable_random_resource to 1 if you don't want mcabber to add a random# suffix to the resource name.#set resource = mcabber#set disable_random_resource = 0#set priority = 3#set priority_away = 0# Set 'ignore_self_presence' to 1 if you do not want to see your own# presence in your roster (default: 0). Other resources will still be# displayed.setignore_self_presence = 1# SSL/TLS options:# TLS is now regarded as the default encryption for connecting to jabber.# You can require TLS by setting tls to 1. If your jabber server# still doesn't support TLS, you can use the old-style SSL by setting# ssl to 1. It's not possible to use old-style SSL and TLS together.#set ssl = 0settls = 1# It is possible to set the allowed ciphers which openssl/gnutls can use for# the encrypted connection.# openssl (get the name of the available ciphers via 'openssl ciphers'):#set ssl_ciphers = ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384# gnutls (check the priorities option of 'man gnutls_priority_init'):#set ssl_ciphers = PFS# If you'd like to explicitly specify trusted certificates, set the ssl_ca# option to a certificate file or path.#set ssl_ca = ~/.mcabber/trusted_cert.pem# Moreover, it's possible to check whether the fingerprint of the# ssl certificate matches ssl_fingerprint.# You can get the fingerprint of your server either with gnutls or openssl:# 1. gnutls-cli -p 5223 $your_server# 2. openssl s_client -starttls xmpp -connect $yourserver:5222 | \# openssl x509 -fingerprint -sha256 -noout#set ssl_fingerprint = SHA256:647d2eef7f972001d4fe8b6bedb3007d095dcd982ebb6773c6fb74adb8cc27c0# Set ssl_ignore_checks to 1 to disable all certificate checks except the# fingerprint check.#set ssl_ignore_checks = 0# PGP support# Set pgp to 1 to enable OpenPGP.# To sign outgoing messages, select your private key id with# the pgp_private_key option. You cannot change these options once# mcabber is running.# Note: you can get the Key Id with gpg: "gpg --list-keys --keyid-format long"#set pgp = 0#set pgp_private_key = "C9940A9BB0B92210"## You can set your PGP passhrase here, although it's NOT advised.#set pgp_passphrase = "PGPpassword"## If you don't like the default number of passphrase retries (2), you# can change it here. If this number is < 0, mcabber will keep asking# until the passphrase is good.#set pgp_passphrase_retries = 2## You can specify the path to the gpg binary, e.g. to force the use of# GnuPG version 1 on systems which have both versions installed.#set gpg_path = /usr/bin/gpg## If GnuPG should use a custom configuration directory, you can set# 'gpg_home' to the desired path.#set gpg_home = ~/.mcabber/gpg# Conference nickname# This nickname is used when joining a room, when no nick is explicitly# specified by the user. Note that when the nickname option is not set,# the jid variable can be used.#set nickname = Abitbol# Proxy# mcabber can use a proxy if it supports the CONNECT method# The proxy_user/proxy_pass variables are optional.#set proxy_host = "proxy-hostname"#set proxy_port = 3128#set proxy_user = "username"#set proxy_pass = "password"# Keepalive# If you need a ping/keepalive to leave your connection open, you# can use the pinginterval. Setting this option to 0 disables the ping.# Default value is 40 seconds.#set pinginterval = 40# Language# Help files have been translated into a few languages.# You can set lang to a semicolon separated list of the following# values: en, cs, de, fr, it, nl, pl, ru, uk. If you omit this,# mcabber will try to autodetect it from your locale, with fallback# to en.# You also can specify a list of directories, where help is located,# for example, if your mcabber is installed with another prefix than# your modules.# This may be convenient to print help not into the status buffer, but into# currently opened buffer. For that set help_to_current option.#set lang = en#set help_dirs = "/usr/share/mcabber/help;~/share/mcabber/help"#set help_to_current = 0# Aspell# If your mcabber has been built with Aspell support, you can enable spell# checking with the following options (you can't change them once mcabber is# running).#set spell_enable = 1#set spell_lang = en_US ru_RU#set spell_encoding = iso8859-1#set spell_encoding = UTF-8# History# Number of lines to remember for the command line history# (default: 0, unlimited).setcmdhistory_lines = 250# Let MCabber accept some vi(1)-like "normal mode" commands by setting the# option 'vi_mode' to 1 (default: 0).#set vi_mode = 1# You can set up a mask to filter buddies and display them according to# their status. The mask should contain the shortcut letters of the# status you want to see ([o]nline, [f]ree_for_chat, [d]o_not_disturb,# [n]ot_available, [a]way, [_]offline).# For example, to display everybody the filter should be "ofdna_" (default).# To display only the connected buddies, use "ofdna".# Please note that this option is only used at startup (once mcabber is# running you can use "/roster display").#set roster_display_filter = ofdna_# By default, mcabber adds a leading space before each buddy in the roster. You# can remove it to gain a little space.#set roster_no_leading_space = 0# By default command line completion is case-sensitive; this can be changed# by setting the option 'completion_ignore_case' to 1.#set completion_ignore_case = 0# Message Carbons (XEP-0280)# If you want to enable Message Carbons at startup (and if your server# supports them), set the 'carbons' option to 1. Default is 0.#set carbons = 1# Set the 'clear_unread_on_carbon' option to 1 if the unread messages flag# should be cleared when an outgoing copy of a message sent to that contact# is received from another client. Default is 0.#set clear_unread_on_carbon = 1# Typing notifications, Chat States, Events (XEP-22/85)# Set disable_chatstates to 1 if you don't want to use typing notifications.# Note: changing this option once mcabber is running has no effect.#set disable_chatstates = 0# History logging# You can save the messages history: set logging = 1# Set 'logging_ignore_status' to 1 if you do not want to save status changes# (and status messages) to the log files (default: 0).# You can load (read) the messages history: set load_logs = 1# If you enable load_logs, you can use the 'max_history_age' setting below.# The default logging directory (logging_dir) is $HOME/.mcabber/histo/# (or $XDG_CONFIG_HOME/mcabber/histo/).# Defaults for logging, load_logs are 0 (disabled)# Note: the logging directory path is created if absent.# Note: these options, except 'max_history_age' and 'max_history_blocks',# are used at startup time.#set logging = 1#set load_logs = 1#set logging_dir = ~/.mcabber/histo/#set logging_ignore_status = 1# Set log_muc_conf to 1 to enable MUC chatrooms logging (default = 0)#set log_muc_conf = 1# Set load_muc_logs to 1 to read MUC chatrooms logs (default = 0). These# logs will be displayed in the buffer window _before_ any history received# from the server.#set load_muc_logs = 0# When load_logs (or load_muc_logs) is enabled, you can specify a maximum# number of history days to load into memory with max_history_age.# Default = 0 (disabled -- everything is loaded)# Note: this option is only used when reading history files, not later.#set max_history_age = 0# mcabber can store the list of unread messages in a state file,# so that the message flags are set back at next startup.# Note that 'logging' must be enabled for this feature to work.#set statefile = ~/.mcabber/mcabber.state# You can specify a maximum number of data blocks per buffer (1 block contains# about 8kB). The default is 0 (unlimited). If set, this value must be > 2.setmax_history_blocks = 8# IQ settings# Set iq_version_hide_os to 1 if you do not want to allow people to retrieve# your OS version.#set iq_version_hide_os = 0## Set iq_version_hide_version to 1 if you do not want to allow people to# retrieve your mcabber version.#set iq_version_hide_version = 0## Set iq_time_hide to 1 if you do not want to allow people to retrieve# your OS time.#set iq_time_hide = 0## Set iq_last_disable to 1 if you want to disable response to jabber:iq:last# queries (XEP-0012). Set iq_last_disable_when_notavail to 1 if you want# to disable Last Activity reports only when the not-available status is set.# (Default is 0 for both options)#set iq_last_disable = 0#set iq_last_disable_when_notavail = 1## Set iq_hide_requests to 1 if you don't want received IQ requests to be# displayed in the status window (default: 0).#set iq_hide_requests = 1# Modules# If mcabber is built with modules support, you can specify the path# to the directory where your modules reside. Though, default compiled-in# value should be appropriate.#set modules_dir = /usr/lib/mcabber/# Beep# Set beep_on_message to 1 if you want mcabber to beep when receiving# a new message (except in chatrooms). If you want a more sophisticated# system (e.g. play a sound), have a look at 'events_command' below.#set beep_on_message = 0# External command for events# You can specify a script or process to be launched when an event occurs.# Set 'events_ignore_active_window' to 1 if you don't want the script to# be run for a message to the current active window (default: 0).## If 'event_log_files' is set, a file is created and contains the body of# the message (incoming messages only); the file name is the last parameter.# If you enable this, you can specify the directory mcabber will use to# create these messages with the 'event_log_dir' variable (default is the# system temp dir, or MCABBERTMPDIR environment variable). Please note# that mcabber won't delete these files, it's your script's job.## The command is called the following way:# $events_command MSG IN jabber@id [file] (when receiving a message)# $events_command MSG OUT jabber@id (when sending a message)# $events_command MSG MUC room_id [file] (when receiving a MUC message)# $events_command STATUS X jabber@id (new buddy status is X)# $events_command UNREAD "N x y z" (number of unread buddy buffers)# (x=attention y=muc unread buffers z=muc unread buffers with attention sign)# See sample script in contrib/ directory.#set events_command = ~/.mcabber/eventcmd##set events_ignore_active_window = 0##set event_log_files = 0#set event_log_dir = ~/.mcabber/event_files# If you set 'eventcmd_use_nickname' to 1, mcabber will pass the nickname# (if it is defined) to the event script instead of the JID (default: 0).#set eventcmd_use_nickname = 0# External command status check# You can request mcabber to inspect exit status value after each# events_command. If this option is set, mcabber will beep if the# exit value is 2.#set eventcmd_checkstatus = 0# Internal hooks# You can ask mcabber to execute an internal command when a special event# occurs (for example when it connects to the server).## 'hook-post-connect' is executed when mcabber has connected to the server# and the roster has been received.#set hook-post-connect = status dnd## 'hook-pre-disconnect' is executed just before mcabber disconnects from# the server.#set hook-pre-disconnect = say_to foo@bar Goodbye!# FIFO# mcabber can create a FIFO named pipe and listen to this pipe for commands.# Don't forget to load the FIFO module if you plan to use this feature!# Default: disabled.# Set 'fifo_hide_commands' to 1 if you don't want to see the FIFO commands# in the log window (they will still be written to the tracelog file).# When FIFO is configured, you can turn it off and on in real time with# the 'fifo_ignore' option (default: 0). When set to 1, the FIFO input is# still read but it is discarded.#set fifo_name = ~/.mcabber/mcabber.fifo#set fifo_hide_commands = 0#set fifo_ignore = 0##module load fifo# URL extractor# Set 'url_regex' to a regular expression matching urls. If it matches an# url in an incoming messages, it'll print it to the log window.# Don't forget to load the urlregex module if you plan to use this feature!#set url_regex = "(((https?|ftps?|nntp)://)|www[.][-a-z0-9.]+|(mailto:|news:))(%[0-9A-F]{2}|[-_.!~*';/?:@&=+$,#[:alnum:]])+"##module load urlregex# Traces logging# If you want advanced traces, please specify a file and a level here.# There are currently 4 tracelog levels:# lvl 1: most events of the log window are written to the file# lvl 2: Loudmouth verbose logging# lvl 3: debug logging (XML, etc.)# lvl 4: noisy debug logging (Loudmouth parser...)# Default is level 0, no trace logging#set tracelog_level = 1#set tracelog_file = ~/.mcabber/mcabber.log# Set the auto-away timeout, in seconds. If set to a value >0,# mcabber will change your status to away if no real activity is detected# (command, message, move in the buddylist...). Note: auto-away only changes# the status when it is "available" (online) or "free_for_chat".# See 'message_autoaway' below.#set autoaway = 0# Message blocking# Set 'block_unsubscribed' to 1 if you want to block (drop) incoming# messages from people you haven't authorized. (default: 0)#set block_unsubscribed = 0## Set 'delete_on_reject' to 1 if you want to delete buddies from your# roster when you reject their subscription request. (default: 0)# (See documentation for /event)# The buddy is actually deleted only if there is no other subscription,# so for example if you are subscribed to this buddy's presence updates it# won't be deleted.#set delete_on_reject = 0# MUC# Set 'muc_flag_joins' to 1 if you want the MUC rooms to be flagged in# the roster when somebody joins a room. Set it to 2 if you want a flag# for leaves too.#set muc_flag_joins = 0# Set 'muc_print_status' to see status changes in MUC rooms:# 1: (none) do not display joining/leaving members# 2: (in_and_out) display joining/leaving members# 3: (all) display joining/leaving members and member status changes# (default: in_and_out)#set muc_print_status = 2# Set 'muc_auto_whois' to 1 if you want to call /room whois each time# somebody joins a room. (default: 0)#set muc_auto_whois = 0# Set 'muc_print_jid' to see real jid in non-anonynmous room when somebody# joins. This setting will be ignored when auto_whois is enabled.# 0: only nick (don't print jid even if available)# 1: nick and bare jid# 2: nick and full jid with resource#set muc_print_jid = 1## Set 'muc_disable_nick_hl' to 1 if you don't want mcabber to color lines# containing your nickname in a MUC room.#set muc_disable_nick_hl = 0## Set 'muc_completion_suffix' if you want mcabber to append a string to# suggested nicknames (only at the beginning of a line), like ":" or ",".# (Default: none)#set muc_completion_suffix = ": "## Set 'muc_bookmark_autoupdate' to 1 if you want changes made to room options# be stored automatically on server. Otherwise you'll have to manually use# command /room bookmark, or changes will not be permanent (for session only).# This setting will not add any bookmark, only update already existing ones.#set muc_bookmark_autoupdate = 0# Status messages# The 'message' value will override all others, take care!#set message = Unique message status#set message_avail = I'm available#set message_free = I'm free for chat#set message_dnd = Please do not disturb#set message_notavail = I'm not available#set message_away = I'm away## The auto-away message is only used when 'autoaway' is set. The previous# message will be restored when leaving auto-away status. If this message# isn't defined, the status message will stay unchanged.setmessage_autoaway = Auto-away (idle)# Escape timeout delay (ESCDELAY)# The ESCDELAY variable specifies the time, in milliseconds, for which# the ncurses interface will await a character sequence.# The default is 1000 (1 second).# If you want mcabber to react faster after hitting Escape, you can lower# this value by setting the ESCDELAY environment variable or setting the# 'escdelay' option.setescdelay = 50# Colors# Colors are: black, red, green, yellow, blue, magenta, cyan, white# For text colors (i.e. not background and bg* colors) you can also use# the "bright" prefix to get a bright/bold color. Example: brightblue# You can use the "default" color, too (i.e. for transparent background).# If your terminal supports 256 colors, you can use the color number# directly (16-255).## Have a look at the contrib/themes/ directory to see some sample# color settings.## background: background color of the chat window and the log window# general: text color in the chat window and the log window# info: text color in the chat window for info messages# msgin: text color in the chat window for incoming messages# msgout: text color in the chat window for outgoing messages# msghl: text color in the chat window for highlighted messages (MUC)# bgstatus: background color of the status lines# status: text color of the status lines# log: text color in the log window# roster: text color of the roster (buddylist) normal items# bgrostersel: background color of the selected roster item# rostersel: text color of the selected roster item# rosterselmsg:text color of the selected roster item, if there is a new msg# rosternewmsg: text color of items with unread messages# readmark: text color of the "read mark" line in buffers# timestamp: text color in the chat window for delayed timestamps##set color_background = black#set color_general = white#set color_info = white#set color_msgin = white#set color_msgout = cyan#set color_msghl = yellow#set color_bgstatus = blue#set color_status = white#set color_log = white#set color_roster = green#set color_bgrostersel = cyan#set color_rostersel = blue#set color_rosterselmsg = red#set color_rosternewmsg = red#set color_readmark = red#set color_timestamp = brightblue# You can color roster items by their status and JID. For example, to have# all roster items white, just all contacts from jabber.org that are away,# not available or do not disturb yellow, you do this:##color roster * * white#color roster adn *@jabber.org yellow# You can let mcabber color nicks in MUC.# These colors will by used automatically:#set nick_colors = red green blue# This turns coloring of all mucs on:#color muc * on## If you want someone's nick to be the same all the time:#color mucnick my_friend yellow# Style# Note: the 'log_win_height' and 'roster_width' values below can be set# in real time when mcabber is running. Refresh the screen (Ctrl-l) to# use the new values.## Log window height (minimum 1, default 5)#set log_win_height = 5# Buddylist window width (minimum 2, default 24)#set roster_width=24## The options 'log_win_on_top' and 'roster_win_on_right' can change the# position of the log window (top/bottom) and the position of the roster# (left/right).#set log_win_on_top = 0#set roster_win_on_right = 0## The attention sign (default: '!') used when a private message is received# can be changed with the 'attention_char' option.#set attention_char = !## By default, the displayed name of a contact in the roster window will# be the JID if no name has been specified. You can use the following# option if you only want to see the username part.#set roster_hide_domain = 0## Buddy name format (in status window):# - 0: (default) "<jid/resource>"# - 1: "name <jid/resource>" (name is omitted if same as the JID)# - 2: "name/resource" (if the name is the same as the JID, use <jid/res>)# - 3: "name" (if the name is the same as the JID, use <jid/res>)#set buddy_format = 2## Time format:# - 0: (default) Date and time# - 1: Time only# - 2: None#set time_prefix = 0## When a contact sends "/me ", mcabber displays "*user ", where user# is the local part of the contact's JID.# If you want mcabber to display the complete bare JID (user@server.com),# set 'buddy_me_fulljid' to 1 (default: 0)#set buddy_me_fulljid = 1## Display the status changes in the log window (default: 0, never)# Set 'log_display_presence' to 1 to enable.#set log_display_presence = 0## Display the status changes in the chat buffers (default: 0, never)# Values: 0: never 1: only connect/disconnect 2: all#set show_status_in_buffer = 1## Set 'log_display_sender' to 1 to display the message sender's JID in the# log window (default: 0, no)#set log_display_sender = 0## Set 'info' to anything you'd like to see in your lower status line.#set info = woot## Automatic locking on buddy resource that messages are coming from.# Useful when your buddies are chatting from their non-highest priority# resources, forcing you to use /say_to command.#set roster_autolock_resource = 1## Automatic locking of buffer when scrolled up, and unlocking when scrolled# to bottom.# Set 'buffer_smart_scrolling' to 1 to enable.# Note: manual command "/buffer scroll_lock" will not work when smart scrolling# is enabled. Command "/buffer scroll_unlock" will only work if there is a new# message received.#set buffer_smart_scrolling = 0# Contacts PGP information# You can provide a PGP key to be used for a given Jabber user, or# disable PGP on a per-account basis.# If you provide a KeyId for a contact, it will be compared to the key the# contact uses to sign their presence/messages and it will be used for# all outgoing encrypted messages (that is, the contact signature key will# be ignored).# Please note that the key must match exactly the id seen with /info.#pgp disable foo@bar.org#pgp setkey bar@foo.net C9940A9BB0B92210# OTR (Off-The-Record messaging) support# (Only available if mcabber is built with OTR support)# Set otr to 1 to enable OTR support.# You cannot change this option once mcabber is running.#set otr = 0## OTR directory# You can specify the OTR directory with the otr_dir option# (default = ~/.mcabber/otr/).#set otr_dir = "~/.mcabber/otr/"## You can set OTR policies from the configuration file (use /help otrpolicy# for the details).#otrpolicy default manual# Entity Caps cache# You can provide a directory where mcabber will store an offline cache# of other clients' capabilities. This will likely reduce network overhead# on start of new session.#set caps_directory = "~/.mcabber/caps"# Aliasesaliasme = say /mealiasonline = statusonlinealiasaway = statusawayaliasdnd = statusdndaliasnotavail = statusnotavail#alias names = room names#alias topic = room topic# Set use_mouse to 1 to map mouse buttons like keycodes.#set use_mouse = 1# Key bindings# Ctrl-q (17) bound to /roster unread_nextbind17 = rosterunread_next# Ctrl-x (24) bound to /roster alternatebind24 = rosteralternate# F5 (269) bound to /roster toggle_offline (centericq-like, IIRC)bind269 = rostertoggle_offline# F12 (276) bound to /roster togglebind276 = rostertoggle# Ctrl-Up/Ctrl-Down bound to /buffer up/down (like Ctrl-p/Ctrl-n)bind521 = bufferupbind514 = bufferdown# Sample alias to join mcabber channel with "/jmc"#alias jmc = room join mcabber@conf.lilotux.net