Mcabber

From Telecomix Crypto Munitions Bureau

Jump to: navigation, search

mcabber is a console program that works with linux and perhaps some other unix, for doing jabber/XMPP.

Contents

[edit] Startup script 

set jid = YOURNICK@SERVER
set password = "YOUR PASSWORD HERE"
set server = SERVERNAME_HERE
#set port = 5222
set resource = sekrit                     # this field is used to inform others about where you are or which computer you use :O!
#set disable_random_resource = 0

set username = YOUR_USERNAME_HERE         # optionally enclose it in "" if it contains space. i guess.

#set priority = 3
#set priority_away = 0

set ignore_self_presence = 1

set tls = 1
set ssl_fingerprint = c0:aa:8a:96:73:2e:fa:52:2c:1e:13:1d:1c:e5:0b:ef:78:58:08:08        # SET THIS TO YOUR SERVERS KEY!!!!!!!!!!1111
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

set nickname = YOURNICK

#set pinginterval = 40
set spell_enable = 0
set cmdhistory_lines = 250
#set roster_display_filter = ofdna_    # display all friends
set disable_chatstates = 1             # disables notifies to others that you are typing to them

set logging = 0                        # be polite and do not log
set load_logs = 0
set logging_dir = ~/.mcabber/histo/    # in case you change your mind
set logging_ignore_status = 1
set log_muc_conf = 0                   # do not log multi user chats
set load_muc_logs = 1                  # load backlog

set statefile = ~/.mcabber/mcabber.state
set max_history_blocks = 8

set iq_version_hide_os = 1             # do not tell others which OS you are using
set iq_last_disable = 1
set iq_last_disable_when_notavail = 1
#set iq_hide_requests = 1

set beep_on_message = 0

set hook-post-connect = status available

set autoaway = 0                      # never inform others that you are not at the keyboard

set muc_print_status = 2              # show when people join/part a channel.
set muc_auto_whois = 0                # set to 1 if you are paranoid

set message = ohai
#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

set escdelay = 50

set time_prefix = 1

# 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

# Aliases
alias me = say /me
alias online   = status online
alias away     = status away
alias dnd      = status dnd
alias notavail = status notavail
#alias names = room names
#alias topic = room topic

[edit] GPG

Create a GPG key that has the same name as your JID. (yournick@example.org) 

gpg --gen-key

Make sure to copy the key somewhere safe. Then read the config file and add your key ID to the place where it should be.

[edit] Adding a friends GPG

Adding a friend to your keyring can be done while running mcabber. No need for restart.

To add a friend to your keyring: 

gpg --keyserver hkp://KEYSERVER --search-keys NICKNAME

(oh, and MAKE SURE ITS ACTUALLY YOUR FRIEND AND NOT SOME NSA SPY!!!)

When you chat with your friend, the arrows before each message will change in appearance if the message is encrypted. 

--> this is unencrypted
<== this is unencrypted too

<~= this is encrypted
-~> this is also encrypted
Notice the arrows.

[edit] Problems?

If only one of you can see the others messages (like in the picture above, in the beginning) it is because someone has used the wrong key. Add the GPG key again, and perhaps remove the old one :)

[edit] Adding your own GPG key to a keyserver

Listing the keys you have. 

gpg --list-keys

Each key will have its own serial number. Like D0FE7AFB, but a different number for you :)

Uploading a key. 

gpg --send-keys D0FE7AFB                                  # upload to the universal super-duper-keyserver
gpg --keyserver SERVERNAME --send-keys D0FE7AFB           # upload to a specified keyserver
Retrieved from "http://cryptoanarchy.org/wiki/Mcabber"
Personal tools