2014-09-02 18:54:42 +00:00
Tox-WeeChat
===========
2014-09-17 15:49:12 +00:00
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 and not intended for general use yet.
2014-09-02 18:54:42 +00:00
2014-09-17 15:49:12 +00:00
Current build status: [](https://travis-ci.org/haavardp/tox-weechat)
2014-09-02 20:38:30 +00:00
2014-09-02 18:54:42 +00:00
Installation
------------
2014-09-18 16:16:15 +00:00
Tox-WeeChat requires [WeeChat][1] >=1.0, [libjansson][3] >=2.5, and the latest-ish [libtoxcore][4]. It also requires CMake to be built. Installation is fairly simple:
2014-09-02 18:54:42 +00:00
2014-09-02 19:10:00 +00:00
$ git clone https://github.com/haavardp/tox-weechat.git
$ cd tox-weechat
2014-09-02 21:27:53 +00:00
$ mkdir build & & cd build
2014-09-11 02:06:20 +00:00
$ cmake -DHOME_FOLDER_INSTALL=ON ..
$ make
$ make install
2014-09-17 15:49:12 +00:00
This installs the plugin binary `tox.so` in the recommended location `~/.weechat/plugins` . Omitting the home folder flag installs it to `/usr/local/lib/weechat/plugins` . Install anywhere else by setting `INSTALL_PATH` .
2014-09-02 18:54:42 +00:00
Usage
-----
2014-09-13 10:22:26 +00:00
- In WeeChat, load the plugin with `/plugin load tox` . If it fails, try specifying the full path to the binary.
2014-09-17 15:49:12 +00:00
- Create a new identity with `/tox add <name>` . The data file is stored in `<WeeChat home>/tox/` by default.
- Connect your identity to the Tox network with `/tox connect <name>` .
- Change your name with `/name <new name>` .
2014-09-02 18:54:42 +00:00
- Get your Tox address with `/myaddress` .
- To add friends or respond to friend requests, `/help friend` will get you started.
2014-09-17 15:49:12 +00:00
- Message a friend with `/msg <friend number>` . Get their friend number with `/friend list` .
2014-09-02 18:54:42 +00:00
2014-09-02 22:22:35 +00:00
A list of commands is available with `/help -list tox` .
2014-09-02 18:54:42 +00:00
2014-09-18 15:59:43 +00:00
TODO & Implemented features
2014-09-10 22:29:09 +00:00
----
2014-09-17 15:49:12 +00:00
- [x] Adding friends, one-to-one chats
2014-09-13 10:22:26 +00:00
- [x] Support multiple identities
2014-09-18 15:59:43 +00:00
- [x] Save friend requests
2014-09-17 22:15:53 +00:00
- [ ] Encrypted save files
2014-09-13 19:24:11 +00:00
- [ ] Tox DNS
2014-09-17 15:49:12 +00:00
- [ ] Group chats (awaiting libtoxcore implementation)
- [ ] Support proxies (TOR)
- [ ] A/V (long term)
2014-09-10 22:29:09 +00:00
2014-09-02 18:54:42 +00:00
License
---------
Tox-WeeChat is licensed under the MIT license. For more information, see the LICENSE file.
2014-09-02 19:10:00 +00:00
Copyright (c) 2014 Håvard Pettersson < haavard.pettersson @ gmail . com > .
2014-09-02 18:54:42 +00:00
[1]: http://weechat.org
[2]: http://tox.im
2014-09-18 14:08:48 +00:00
[3]: http://www.digip.org/jansson/
[4]: https://github.com/irungentoo/toxcore
2014-09-02 19:14:05 +00:00
