Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

WeeChat Qt remote GUI

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 requires:

  • Python ≥ 3.7
  • PySide6
  • WeeChat ≥ 0.3.7, on local or remote machine, with relay plugin enabled and listening on a port with protocol "weechat"

Install via source distribution

$ pip 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:

  • hostname: 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)
  • totp: the Time-Based One-Time Password (optional, to set if required by WeeChat)

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


Copyright © 2011-2022 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