WeeChat script for Off-the-Record messaging
Clone or download


WeeChat script for Off-the-Record (OTR) Messaging


Please note: This script makes every effort to securely provide OTR Messaging in WeeChat but offers no guarantee. Please report any security problems you find.

Testing and security auditing are appreciated.

Build Status


This script requires Weechat 0.4.2 or later and the Pure Python OTR package to be installed with one of the following methods:

Python package:

pip install --upgrade --user python-potr

If this fails, read Requirements for building Pure Python OTR below.


yaourt -S python2-potr

Debian based systems:

sudo apt-get install python-potr

The latest release version of WeeChat OTR can be found in the WeeChat scripts repository. To install from within WeeChat:

/script install otr.py

To install manually, download weechat_otr.py from GitHub and save it in ~/.weechat/python. Then either symlink it into ~/.weechat/python/autoload or /python load weechat_otr.py in WeeChat.

Latest unstable version from GitHub

If you are using an official release of the script, it is a good idea to verify the signature.

Requirements for building Pure Python OTR

If python-potr fails to install, you are probably missing some packages. To install all the requirements on a Debian/Ubuntu system, run

sudo apt-get install python-pip python-wheel build-essential python-dev

Or on Arch run

sudo pacman --needed -S python2-pip python2-wheel python2-keyring base-devel

Buffer Local Variables

The script will set the following buffer local variables:

  • localvar_set_otr_encrypted - whether the buffer is OTR encrypted (true or false)
  • localvar_set_otr_authenticated - whether the buffer is OTR authenticated (true or false)
  • localvar_set_otr_logged - whether the buffer is logged (true or false)

These match what is shown in the status bar and can be used by remote interfaces via the WeeChat relay protocol or by other scripts.


IRC channel: #weechat-otr on Freenode

Create GitHub issues/pull requests for questions, comments and patches or email matthewm@boedicker.org or koolfy@koolfy.be.


Thanks to Kjell Braden for the Pure Python OTR library and the Gajim Python plugin which was used as a reference.