tox plugin for weechat - tox running as a weechat window

Go to file

Håvard Pettersson 1c051cbc86 Added TODO list.		2014-09-11 00:29:09 +02:00
src	Fixed identity initialization.	2014-09-08 03:03:12 +02:00
.gitignore	Fixed YCM config gitignore.	2014-09-02 13:58:10 +02:00
.travis.yml	Use WeeChat 1.0 on Travis.	2014-09-03 14:36:54 +02:00
CMakeLists.txt	Improved build process and instructions.	2014-09-11 00:25:05 +02:00
LICENSE	Added README.md and LICENSE.	2014-09-02 20:54:42 +02:00
README.md	Added TODO list.	2014-09-11 00:29:09 +02:00

README.md

Tox-WeeChat

Tox-WeeChat is a C plugin for the WeeChat chat client that enables it to connect to the Tox network. It is functional, but fairly limited in features for now. Bug reports and suggestions are appreciated.

Installation

Tox-WeeChat requires libtoxcore (and WeeChat) to work. After getting them, install Tox-WeeChat like this:

$ git clone https://github.com/haavardp/tox-weechat.git
$ cd tox-weechat
$ mkdir build && cd build
$ cmake -DHOME_FOLDER_INSTALL=ON ..
$ make install

This builds the plugin binary tox.so and installs it to ~/.weechat/plugins/. If your WeeChat home is somewhere else, or you'd like to install the plugin in a different location (e.g. /usr/local/lib/weechat/plugins), replace the last command with a simple make and manually move tox.so to the correct location.

Usage

In WeeChat, load the plugin: /plugin load tox. In cases where WeeChat can't find the plugin, try specifying the full path to the binary. You should get a new buffer called tox. This is the core Tox buffer, where output from commands will appear.

To change your name, /name <new name>.
Get your Tox address with /myaddress.
To add friends or respond to friend requests, /help friend will get you started.
Message a friend with /msg <friend number>. Get their friend number with /friend.

A list of commands is available with /help -list tox.

TODO

Support multiple identities (in progress)
Preserve friend requests when closing
Group chats
Polish and reach a "stable" release

License

Tox-WeeChat is licensed under the MIT license. For more information, see the LICENSE file.