emdee/tox-weechat
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
tox-weechat/README.md
Håvard Pettersson 6cdb71e086 Changed license to GPL3.
2014-09-18 18:56:43 +02:00

2.7 KiB
Raw Blame History

Tox-WeeChat

Tox-WeeChat is a C plugin for the WeeChat chat client that enables it to connect to the Tox network. It is functional, but fairly limited in features and not intended for general use yet.

Current build status: Build Status

Installation

Tox-WeeChat requires WeeChat >=1.0, libjansson >=2.5, and the latest-ish libtoxcore. It also requires CMake to be built. Installation is fairly simple:

$ git clone https://github.com/haavardp/tox-weechat.git
$ cd tox-weechat
$ mkdir build && cd build
$ cmake -DHOME_FOLDER_INSTALL=ON ..
$ make
$ make install

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.

Usage

  • In WeeChat, load the plugin with /plugin load tox. If it fails, try specifying the full path to the binary.
  • 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>.
  • Get your Tox address with /myaddress.
  • 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.

A list of commands is available with /help -list tox.

TODO & Implemented features

  • Adding friends, one-to-one chats
  • Support multiple identities
  • Save friend requests
  • Encrypted save files
  • Tox DNS
  • Group chats (awaiting libtoxcore implementation)
  • Support proxies (TOR)
  • A/V (long term)

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