mcabber with OTR on FreeBSD
                  ===========================

 Last edited: $Date: 2021/11/20 13:22:06 $

                            mcabber
                            --------

 mcabber  is a great  XMPP (Jabber) console client.  It has all
 the important features and is easy use.

 XMPP is an open standard for messaging and presence.  XMPP  is
 the   Extensible  Messaging  and  Presence  Protocol  that  is
 developed in 1999 by Jeremie Miller. He called it jabber.

                  Federated instant messaging
                  ----------------------------

 XMPP is a decentralised system, that means that everybody  can
 set  up a XMPP server, nobody owns the network and the network
 can not be closed down by a single authority.

 It is a federated system. The users of one server can exchange
 messages with the users of another server.

                     Privacy by encryption
                     ---------------------

 The  XMPP  supports  the  use  of  encryption  to  protect the
 confidentiality of the messages. So, your chat is  secured  by
 encryption against eavesdropping.

 There are two methods to protect your messages:

 - Encryption with OpenPGP
 - Encryption with OTR

 mcabber supports both methods.

                              OTR
                              ---

 OTR  or "Off-the-Record Messaging" is a cryptographic protocol
 that provides encryption for instant messaging conversations.

 OTR is easy to set up, doesn't require the user to maintain  a
 public and private key pair, and supports forward secrecy.

                  mcabber with OTR on FreeBSD
                  ---------------------------

 The  FreeBSD  binary package for mcabber has not been compiled
 with support for OTR.

 Because this is one of the very few applications I compile and
 build, I have not installed the ports tree.

 So,  I  did  fetch  the  tar-ball  with  the  source code from
 https://mcabber.com and compiled this.

 ### Dependencies

 You have to install the following packages:

   gmake
   pkgconf
   glib-2
   libotr-4

 Fetch and unpack the  tar-ball  (mcabber-1.1.2.tar.bz2  in  my
 case).

 Than,  run the traditional combo of ./configure, make and make
 install:

   ./configure --enable-otr
   gmake
   gmake install

 To be able to manage  any  self  compiled  applications,  [GNU
 stow](https://www.gnu.org/software/stow/) can be used. In that
 case, set the prefix accordingly.

   ./configure --enable-otr --prefix=/usr/local/stow/mcabber

                    Starting encrypted chat
                    ------------------------

 An easy way to use OTR on mcabber is to set the OTR policy  to
 opportunistic.

 Add the following lines to the ~/.mcabber/mcabberrc file:

   set otr = 1
   set otr_dir = "~/.mcabber/otr/"
   set otrpolicy default opportunistic

 Make  sure the directory "~/.mcabber/otr/" does exists.  Start
 mcabber and connect to the jabber-server.

 Set the policy for each contact you want to have a secure chat
 with.

   /otrpolicy JID opportunistic

 Remember that you can use tab-expansion on the JID.

 Make  sure  the  other  party  also has OTR enabled and set to
 opportunistic mode. Now just start chatting, first it will  be
 unencrypted,  but  within  a  very short time you will see the
 friendly message:

   *** OTR: channel established

 Now, the channel is protected by encryption.

 This can be checked by the message indicators:

   -O> : outgoing message is encrypted through OTR
   <O= : incoming message is encrypted through OTR

 Have fun !