2014-09-02 18:54:42 +00:00
Tox-WeeChat
===========
2014-10-08 09:51:50 +00:00
Tox-WeeChat is a [Tox][1] protocol plugin for [WeeChat][2]. It is functional, but lacks certain features like Tox DNS and proxies.
2014-09-02 18:54:42 +00:00
2014-09-30 18:40:24 +00:00
Current build status: [][3]
2014-09-02 20:38:30 +00:00
2014-09-02 18:54:42 +00:00
Installation
------------
2014-09-30 18:40:24 +00:00
> Tox-WeeChat is available in the [AUR][4].
2014-09-18 17:39:40 +00:00
2014-10-04 17:42:30 +00:00
Tox-WeeChat requires [WeeChat][1] >= 1.0.1, [SQLite][5] >= 3.6.19 and the latest-ish [libtoxcore][6]. It also requires CMake to be built. Installation is fairly simple; after getting the source, compile and install using CMake:
2014-09-02 18:54:42 +00:00
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 install
2014-09-28 01:29:34 +00:00
This installs the plugin binary `tox.so` to the recommended location `~/.weechat/plugins` . Without the home folder flag, the binary is placed in `/usr/local/lib/weechat/plugins` . Installing to a custom WeeChat folder or elsewhere is achieved by setting `INSTALL_PATH` .
2014-09-02 18:54:42 +00:00
Usage
-----
2014-09-30 18:40:24 +00:00
- If the plugin does not load automatically, load it with `/plugin load tox` . You may have to specify the full path to the plugin binary.
2014-09-28 01:29:34 +00:00
- Create a new profile with `/tox create <name>` . The data file is stored in `~/.weechat/tox/` by default.
- Load your profile and connect to the Tox network with `/tox load <name>` .
2014-09-17 15:49:12 +00:00
- Change your name with `/name <new name>` .
2014-09-19 15:53:11 +00:00
- Get your Tox ID with `/myid` .
2014-09-02 18:54:42 +00:00
- 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-30 18:40:24 +00:00
Run `/help -listfull tox` to get a list of all available commands.
2014-09-02 18:54:42 +00:00
2014-10-08 09:51:50 +00:00
### Common issues
2014-10-07 10:59:46 +00:00
2014-10-08 09:51:50 +00:00
#### Long Tox names messing up WeeChat layout
2014-10-07 10:59:46 +00:00
Tox allows names up to 128 bytes long. To prevent long names from taking all your screen space, you can set the following options in WeeChat:
- `weechat.bar.nicklist.size_max`
- `weechat.look.prefix_align_max`
- `buffers.look.name_size_max` (if using buffers.pl)
2014-09-28 01:29:34 +00:00
TODO
2014-09-10 22:29:09 +00:00
----
2014-09-28 01:29:34 +00:00
- Support proxies (e.g. TOR)
2014-10-08 09:51:50 +00:00
- Tox DNS
- Encrypted save files
2014-10-05 01:36:14 +00:00
- WeeChat's `/upgrade`
2014-09-30 18:40:24 +00:00
- Audio/video chats
2014-09-10 22:29:09 +00:00
2014-09-02 18:54:42 +00:00
License
---------
2014-09-18 16:55:52 +00:00
Copyright (c) 2014 Håvard Pettersson < haavard.pettersson @ gmail . com >
2014-09-02 18:54:42 +00:00
2014-09-18 16:55:52 +00:00
This file is part of Tox-WeeChat.
Tox-WeeChat 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.
Tox-WeeChat 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 Tox-WeeChat. If not, see < http: / / www . gnu . org / licenses / > .
2014-09-02 18:54:42 +00:00
2014-09-30 18:40:24 +00:00
[1]: http://tox.im
[2]: http://weechat.org
[3]: https://travis-ci.org/haavardp/tox-weechat
[4]: https://aur.archlinux.org/packages/tox-weechat-git
2014-10-04 17:42:30 +00:00
[5]: http://www.sqlite.org
2014-09-30 18:40:24 +00:00
[6]: https://github.com/irungentoo/toxcore
2014-09-02 19:14:05 +00:00
