emdee/tox-weechat
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
tox plugin for weechat. Hard fork of https://github.com/haavard/tox-weechat
85 Commits 1 Branch 0 Tags 676 KiB
C 96.5%
CMake 2.1%
Python 1.2%
Shell 0.2%
dfcb43d4f8
Go to file
Håvard Pettersson dfcb43d4f8 Don't create a new identity if it exists already.
2014-09-17 16:35:36 +02:00
src Don't create a new identity if it exists already. 2014-09-17 16:35:36 +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 More support for multiple identities. 2014-09-13 12:26:27 +02:00
LICENSE Added README.md and LICENSE. 2014-09-02 20:54:42 +02:00
README.md Added Tox DNS lookup to Todo-list. 2014-09-13 21:24:11 +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 for now. Bug reports and suggestions are appreciated.

Build Status

Installation

Tox-WeeChat requires libtoxcore (and WeeChat) to work. After getting them, install Tox-WeeChat like this:

$ 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. To install the plugin somewhere else, replace the cmake command above with either of these:

  • To install to /usr/local/lib/weechat/plugins: cmake ..
  • To install to /usr/lib/weechat/plugins: cmake -DCMAKE_INSTALL_PREFIX=/usr ..
  • To install a custom path: cmake -DINSTALL_PATH=/some/path ..

You may also need to sudo make install, depending on permissions.

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 created in <WeeChat home>/tox/<name> by default.
    • Can be changed with /set tox.identity.<name>.save_file.
  • Connect your new identity to the Tox network with /tox connect <name>.

The following commands must be executed on a Tox buffer:

  • To change your name, /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.

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

TODO

  • Support multiple identities
  • Preserve friend requests when closing
  • Group chats
  • Tox DNS
  • Polish and reach a "stable" release
    • Add autocomplete to all commands

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.