tox plugin for weechat. Hard fork of https://github.com/haavard/tox-weechat

c tox tox-client weechat weechat-scripts

Go to file

nogaems dd8f1f58a8 improve: circumvention of the short ID collisions Even though it's a pretty rare case to happen, it's still possible to occure that there are two+ peers in a group chat with the same first 2 bytes of the ID. Since we're using 2 (that means 4 character length) as a minimal possible value for the shortened ID form, I've changed the ignore list storage in the way that you can now store as many bytes as you want regardless of the option `tox.look.short_id_size`. If the ID collision happens, you can increase the value of that option and you don't have to change your ignore list.		2019-04-02 14:22:56 +03:00
cmake	cmake: fix tox library detection	2018-04-30 17:18:20 +02:00
misc	Bump copyright year	2018-04-12 23:42:34 +02:00
src	improve: circumvention of the short ID collisions	2019-04-02 14:22:56 +03:00
.clang-format	Add .clang-format. Reformat everything.	2017-02-10 19:13:17 -08:00
.gitignore	Formatting and .gitignore	2017-02-03 16:03:47 -08:00
.travis.yml	travis: get WeeChat PGP key from official site	2018-12-26 18:25:01 +01:00
AUTHORS	Implement file transfer feature	2018-05-24 14:13:49 +03:00
CMakeLists.txt	cmake: find WeeChat as REQUIRED	2019-01-19 14:22:38 +01:00
LICENSE	Changed license to GPL3.	2014-09-18 18:56:43 +02:00
README.md	readme: improve build & install instructions	2019-01-19 14:41:35 +01:00

README.md

Tox-WeeChat

Tox-WeeChat is a Tox protocol plugin for WeeChat. It is functional, but lacks certain features that might be expected of a full-fledged Tox client.

Tox-WeeChat is compliant with all "Required" points in the Tox Client Standard.

Features

One-to-one chats
Group chats (text only)
Proxy support
Multiple profiles
Encrypted save files
File transfer

Installation

Tox-WeeChat requires WeeChat (tested with version 2.3) and TokTok c-toxcore (tested with version 0.2.8). CMake 2.8.12 or newer is also required to build. Installation is fairly simple; after getting the source code, 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 WeeChat or toxcore are installed in a non-standard location, you can try specifying CMAKE_PREFIX_PATH to find them; see .travis.yml for an example.

Usage

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 if you installed it to a non-standard location.
Create a new profile with /tox create <profile name>. The data file is stored in ~/.weechat/tox/ by default.
Load your profile and connect to the Tox network with /tox load <profile name>.
Run /help -listfull tox to get a list of all available commands, and /set tox.* for a list of options.

Common issues

Long Tox names messing up WeeChat layout

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)

Tox won't connect through my proxy

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

License

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