Skip to content


Repository files navigation

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

To install manually, download from GitHub and save it in ~/.weechat/python. Then either symlink it into ~/.weechat/python/autoload or /python load 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 or


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


WeeChat script for Off-the-Record messaging






No packages published