Need help with weechat-otr?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

137 Stars 15 Forks 534 Commits 19 Opened issues


WeeChat script for Off-the-Record messaging

Services available


Need anything else?

Contributors list

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
. Then either symlink it into
/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:

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.