47 lines
2.0 KiB
Markdown
47 lines
2.0 KiB
Markdown
Tox-WeeChat
|
|
===========
|
|
Tox-WeeChat is a C plugin for the [WeeChat][1] chat client that enables it to connect to the [Tox][2] network. It is functional, but fairly limited in features for now. Bug reports and suggestions are appreciated.
|
|
|
|
[](https://travis-ci.org/haavardp/tox-weechat)
|
|
|
|
Installation
|
|
------------
|
|
Tox-WeeChat requires [libtoxcore][3] (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.
|
|
|
|
Copyright (c) 2014 Håvard Pettersson <haavard.pettersson@gmail.com>.
|
|
|
|
[1]: http://weechat.org
|
|
[2]: http://tox.im
|
|
[3]: https://github.com/irungentoo/toxcore
|
|
|