Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
qweechat Ignore some flake8 errors Jan 7, 2018
.gitignore Code refactoring, fix May 8, 2014
.mailmap Add a .mailmap file Oct 11, 2014
.travis.yml Add command "qweechat-testproto --version" for Travis May 8, 2014
AUTHORS Use one line titles and less chars for delimited blocks in asciidoc f… Feb 7, 2014
README.adoc Update copyright dates Jan 7, 2018 Update copyright dates Jan 7, 2018



Build Status

QWeeChat is a Qt remote GUI for WeeChat written in Python.


  • Multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & others).

  • Free software, released under GPLv3.

qweechat shadow



Following packages are required:

  • WeeChat (version >= 0.3.7) on local or remote machine, with relay plugin enabled and listening on a port with protocol "weechat"

  • Python 2.x >= 2.6

  • PySide (recommended, packages: python.pyside.*) or PyQt4 (python-qt4)

Install via source distribution

$ python install

WeeChat setup

You have to add a relay port in WeeChat, for example on port 1234:

/set "mypass"
/relay add weechat 1234

Connect to WeeChat

In QWeeChat, click on connect and enter fields:

  • server: the IP address or hostname of your machine with WeeChat running

  • port: the relay port (defined in WeeChat)

  • password: the relay password (defined in WeeChat)

Options can be changed in file ~/.qweechat/qweechat.conf.

Copyright © 2011-2018 Sébastien Helleu <>

This file is part of QWeeChat, a Qt remote GUI for WeeChat.

QWeeChat is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

QWeeChat is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with QWeeChat. If not, see