# vim: set foldmarker={{{,}}} tw=80 ft=conf # Information {{{ # # File: ~/.mcabberrc # Author: kalkin- # Purpose: configuration file for the mcabber jabber client # Version: this file was written and used for mcabber 0.9.4 # # Structure of this file: # I tried to order the options logical, but it doesn't work. I kept # the login options together and ordered everything else # alphabetically. I kept most of the documentation of the original # mcabberrc.example file. # # There are four kinds of things which are defined in this file: # Settings ("set"), aliases ("alias"), bindings ("bind") and commands # - Settings affect the behaviour and the look and feel of # mcabber. # - Aliases replace the commands entered in the command line # - Bindings bind a command normally entered in a command line to # a key # - Commands are executed when mcabber starts. # # Lines started with an hash "#". Some settings are commented out. # Remove the hash to enable them. # # ,----[ $ mcabber -V ] # | MCabber 0.9.6 -- Email: mcabber [at] lilotux [dot] net # | [20:37:10] MCabber 0.9.6 -- Email: mcabber [at] lilotux [dot] net # | # | Installation data directory: /sw/share # | # | Compiled with unicode support. # | Compiled with OpenSSL support. # | Compiled with GPG support. # | Compiled with OTR support. # | Compiled with Aspell support. # `---- # # # Help: # Read the manual, use the /help command, visit and read the resources # links. As last alternative, you can join the mcabber muc room by # entering the command /jmc in the command line. # # Resources: # Mcabber Wiki # Official FAQ # Tips and Tricks # # }}} ####################### Login Settings ######################{{{ # # The jid will be the following: username@server # If your jid's domain name is different from the server name, # you can specify your complete jid as username. set username = kalkin set server = jabber.ccc.de # 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 = "" ####################### / Login Settings #####################}}} # Options with [A] # {{{ # 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 aspell_enable = 1 set aspell_lang = en_EN # set aspell_encoding = iso8859-1 set aspell_encoding = UTF-8 # 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 also 'message_autoaway'. # set autoaway = 0 # }}} # Options with [B] # {{{ # 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 = 1 # 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 # Buddy name format (in status window): # - 0: (default) "" # - 1: "name " (name is omitted if same as the jid) # - 2: "name/resource" (if the name is the same as the jid, use ) # - 3: "name" (if the name is the same as the jid, use ) set buddy_format = 2 # When a contacts 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 #}}} # Options with [C] # {{{ # History # Number of lines to remember for the command line history # (default: 0, unlimited). set cmdhistory_lines = 250 # Colors # ,----[ Valid colors: ] # | black red green yellow # | blue magenta cyan, white # `---- # # Note: # 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) # # You can have a look at the contrib/themes/ directory to see some sample # color settings. # # ,----[ Things that you can color :) ] # | 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 # | 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 # `---- # #set color_background = black set color_general = green set color_info = cyan # set color_msgin = white set color_msgout = yellow set color_msghl = red set color_bgstatus = black set color_status = brightyellow set color_roster = magenta set color_bgrostersel = cyan set color_rostersel = magenta set color_rosterselmsg = brightyellow set color_rosternewmsg = brightyellow # 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 #}}} # Options with [D] # {{{ # Typing notifications, Chat States, Events (JEP-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 # Message blocking # 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 #}}} # Options with [E] # {{{ # 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). # set events_ignore_active_window = 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. # set event_log_files = 0 # If you enable the option above, 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. #set event_log_dir = ~/.mcabber/event_files # 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) # See sample script in contrib/ directory. # set events_command = ~/.mcabber/eventcmd # 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 #}}} # Options with [I] # {{{ # 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 = 1 # }}} # Options with [H] # {{{ # Set hide_offline_buddies to 1 to display only connected buddies # in the roster. set hide_offline_buddies = 1 #}}} # Options with [L] # {{{ # Language # Help files have been translated into a few languages. # You can set lang to one of the following values: en (default), # de, fr, nl, pl, ru, uk. set lang = de # History logging # 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). set logging_ignore_status = 1 # You can load (read) the messages history: set load_logs = 1 set load_logs = 1 # Default logging directory (logging_dir) is $HOME/.mcabber/histo/ # Defaults for logging, load_logs are 0 (disabled) # Note: the logging directory must exist if you enable logging, mcabber # will not create it. # Note: these options, except 'max_history_age' and 'max_history_blocks', # are used at startup time set logging_dir = ~/.mcabber/history/ # 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 # Log window height (minimum 1, default 5) # Note: the "log_win_height" and "log_win_on_top" values below can be set # in real time when mcabber is running. Refresh the screen (Ctrl-l) to # use the new values. set log_win_height = 2 # 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 "log_display_sender" to 1 to display the message sender's jid in the # log window (default: 0, no) # set log_display_sender = 0 #}}} # Options with [M] # {{{ ## 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 = 2 # 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. # set max_history_blocks = 8 # 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 = 1 # 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 = 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 = 1 # Status messages # The "message" value will override all others, take care! # set message = Unique message status set message_avail = Bin da set message_free = ADS! set message_dnd = Nicht stören set message_notavail = Nicht da 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. set message_autoaway = Auto-away (idle) # }}} # Options with [N] # {{{ # You can let mcabber color nicks in MUC. # These colors will by used automatically: set nick_colors = green blue yellow # 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 username variable can be used. set nickname = kalkin #}}} # Options with [O] # {{{ # OTR directory # If mcabber is built with OTR (Off-The-Record) support, you can specify # the OTR directory with the otr_dir option (default = ~/.mcabber/otr/). set otr_dir = "~/.mcabber/otr/" #}}} # Options with [P] # {{{ # 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 # PGP support # Set pgp to 1 to enable OpenPGP. set pgp = 0 # 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 following command: # $ gpg --list-secret-keys --keyid-format long your@email.com # The "sec" id is the one you need set pgp_private_key = "" # You can set your PGP passhrase here, although it's NOT advised. # Not really? :-O # set pgp_passphrase = "" # If port is not given, default Jabber port will be used. #set port = 5222 # Messages that are simply sent to username@domain.com will go to client # with highest priority, but those sent to username@domain.com/mcabber # will only go to the resource mcabber. set priority = 6 # Proxy # mcabber can use a proxy if it supports the CONNECT method # The proxy_user/proxy_pass variables are optional. # set proxy_host = "localhost" # set proxy_port = 9050 # set proxy_user = "username" # set proxy_pass = "password" #}}} # Options with [R] # {{{ # If you don't know what a resource is, you can leave "mcabber" here. set resource = mcabber # Note: the "roster_win_on_right" 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. # 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 roster_win_on_right = 0 #}}} # Options with [S] # {{{ # 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 = 2 # SSL options: # Set ssl non-zero to use SSL (this also sets the default port to 5223). set ssl = 1 # Set ssl_verify to 0 to disable certificate verification, or non-zero # to set desired maximum CA verification depth. Use -1 to specify an # unlimited depth. set ssl_verify = 0 # Set ssl_cafile to a path to a CA certificate file (may contain multiple # CA certificates). # set ssl_cafile = /usr/share/ssl/certs/ca-bundle.crt # Set ssl_capath to a directory containing CA certificates (use c_rehash # to generate hash links). # set ssl_capath = ~/.mcabber/cert/ # Set ssl_ciphers to a list of desired SSL ciphers (run "openssl ciphers" # for candidate values). # set ssl_ciphers = #}}} # Aliases # {{{ alias me = say /me alias online = status online alias away = status away alias dnd = status dnd alias notavail = status notavail # clear skin with clearsil ;) alias cls = clear # Room aliases alias who = room names --quiet alias topic = room topic alias join = room join alias nick = room nick alias invite = room invite alias kick = room kick alias ban = room ban alias unban = room unban alias mod = room role # Sample alias to join mcabber channel with "/jmc" alias jmc = room join mcabber@conf.lilotux.net # }}} # Bindings # {{{ # F5 (269) bound to /roster toggle_offline (centericq-like, IIRC) bind 269 = roster toggle_offline # F3 (267) bound to /roster toggle bind 267 = roster toggle # F1/F2 bound to /roster up/down bind 270= roster up bind 271 = roster down #bind 265= roster up #bind 266 = roster down # C^Z/C^X scroll buffer up/down bind 26 = buffer up 50 bind 24 = buffer down 50 # C^S show next unread msg bind 19 = roster unread_first # C^R jumps to the top of the roster bind 18 = roster top # C^Q jump to my last conversation bind 17 = roster alternate # }}} # Commands # {{{ # Use always OTR when possible: otrpolicy * opportunistic otrpolicy twitter@twitter.com plain otrpolicy *@conference* plain #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 # 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 # }}}