Go to file
Sébastien Helleu e38ef66393 Fix lines displayed in wrong buffer on startup
The bug was introduced by commit 46e5dee03a
(option relay.lines to limit the number of lines received on connection).
2014-05-24 21:42:29 +02:00
qweechat Fix lines displayed in wrong buffer on startup 2014-05-24 21:42:29 +02:00
.gitignore Code refactoring, fix setup.py 2014-05-08 17:40:31 +02:00
.travis.yml Add command "qweechat-testproto --version" for Travis 2014-05-08 18:14:08 +02:00
AUTHORS Use one line titles and less chars for delimited blocks in asciidoc files 2014-02-07 11:11:33 +01:00
COPYING Initial commit 2011-12-06 21:27:09 +01:00
MANIFEST.in Initial commit 2011-12-06 21:27:09 +01:00
README.asciidoc Add Travis build status in README.asciidoc 2014-05-08 18:00:23 +02:00
setup.py Add file version.py to define QWeeChat version 2014-05-08 17:55:28 +02:00

= QWeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en


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

Homepage: http://weechat.org/

image:https://travis-ci.org/weechat/qweechat.svg?branch=master["Build Status", link="https://travis-ci.org/weechat/qweechat"]


== Features

* Multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & others).
* Free software, released under GPLv3.

image::http://static.weechat.org/images/screenshots/medium/qweechat_shadow.png[align="center"]

== Install

=== Dependencies

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 setup.py install
----

== WeeChat setup

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

----
/set relay.network.password "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

Copyright (C) 2011-2014 Sébastien Helleu <flashcode@flashtux.org>

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 <http://www.gnu.org/licenses/>.