2.1 KiB
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
Now, depending on where you want to install the plugin binary:
- To install to
~/.weechat/plugins(recommended):cmake -DHOME_FOLDER_INSTALL=ON .. - To install to
/usr/local/lib/weechat/plugins:cmake .. - To install to
/usr/lib/weechat/plugins:cmake -DCMAKE_INSTALL_PREFIX=/usr .. - To install somewhere else:
cmake -DINSTALL_PATH=/some/path ..
Next, install the plugin. You may need sudo for the last command, depending on install location. $ make $ make install
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 friendwill 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.
Copyright (c) 2014 Håvard Pettersson haavard.pettersson@gmail.com.