emdee/tox-weechat
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
tox plugin for weechat - tox running as a weechat window
181 Commits 1 Branch 0 Tags 637 KiB
C 96.5%
CMake 2.1%
Python 1.2%
Shell 0.2%
9510732626
Go to file
Håvard Pettersson 9510732626 README update; we now support proxies.
2014-10-11 10:32:11 +02:00
build-scripts/arch Added PKGBUILD for Arch linux. 2014-10-06 13:19:37 +02:00
src Renamed some options. 2014-10-11 10:30:05 +02:00
.gitignore Fixed YCM config gitignore. 2014-09-02 13:58:10 +02:00
.travis.yml Mass refactor 💥 2014-09-28 05:20:53 +02:00
CMakeLists.txt Removed -Werror. 2014-10-05 03:57:44 +02:00
LICENSE Changed license to GPL3. 2014-09-18 18:56:43 +02:00
README.md README update; we now support proxies. 2014-10-11 10:32:11 +02:00

README.md

Tox-WeeChat

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

Current build status: Build Status

Installation

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 -DHOME_FOLDER_INSTALL=ON ..
$ make install

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.

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

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)

TODO

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

License

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