by mmb

WeeChat script for Off-the-Record messaging

128 Stars 14 Forks Last release: over 2 years ago (v1.9.2) 534 Commits 12 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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

from GitHub and save it in
. Then either symlink it into
/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:

on Freenode

Create GitHub issues/pull requests for questions, comments and patches or email [email protected] or [email protected]


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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.