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
96 Commits 1 Branch 0 Tags 637 KiB
C 96.5%
CMake 2.1%
Python 1.2%
Shell 0.2%
c9b8f83433
Go to file
Håvard Pettersson c9b8f83433 Added linking to libjansson.
2014-09-18 16:05:10 +02:00
src Added a notice for friends going offline. 2014-09-18 01:27:15 +02:00
.gitignore Fixed YCM config gitignore. 2014-09-02 13:58:10 +02:00
.travis.yml Use WeeChat 1.0 on Travis. 2014-09-03 14:36:54 +02:00
CMakeLists.txt Added linking to libjansson. 2014-09-18 16:05:10 +02:00
LICENSE Added README.md and LICENSE. 2014-09-02 20:54:42 +02:00
README.md Updated TODO. 2014-09-18 00:15:53 +02:00

README.md

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 the latest libtoxcore and WeeChat 1.0. 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
  • Encrypted save files
  • Save friend requests
  • Tox DNS
  • Group chats (awaiting libtoxcore implementation)
  • Support proxies (TOR)
  • A/V (long term)

License

Tox-WeeChat is licensed under the MIT license. For more information, see the LICENSE file.

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