Tox-WeeChat is a Tox protocol plugin for WeeChat. It is functional, but lacks certain features like Tox DNS.

Current build status:

Tox-WeeChat is available in the AUR.

Tox-WeeChat requires WeeChat >= 1.0.1, SQLite >= 3.6.19 and the latest-ish libtoxcore. It also requires CMake to be built. Installation is fairly simple; after getting the source, compile and install using CMake:

$ mkdir build && cd build
$ cmake -DPLUGIN_PATH=~/.weechat/plugins ..
$ make install

This installs the plugin binary tox.so to the recommended location ~/.weechat/plugins. The default location is /usr/local/lib/weechat/plugins.

• 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.
• 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>.
• Change your name with /name <new name>.
• Get your Tox ID with /myid.
• 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 list.

Run /help -listfull tox to get a list of all available commands, and /set tox.* for a list of options.

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)

Make sure the address and port is correct, and that UDP is disabled (/set tox.profile.*.udp).

• Tox DNS
• Encrypted save files
• WeeChat's /upgrade
• Audio/video chats

Copyright (c) 2014 Håvard Pettersson haavard.pettersson@gmail.com

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/.