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
141 Commits 1 Branch 0 Tags 637 KiB
C 96.5%
CMake 2.1%
Python 1.2%
Shell 0.2%
fc44dba8ac
Go to file
Håvard Pettersson fc44dba8ac Fixed typo.
2014-09-28 05:23:18 +02:00
src Mass refactor 💥 2014-09-28 05:20:53 +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 Mass refactor 💥 2014-09-28 05:20:53 +02:00
LICENSE Changed license to GPL3. 2014-09-18 18:56:43 +02:00
README.md Fixed typo. 2014-09-28 05:23:18 +02:00

README.md

Tox-WeeChat

Tox-WeeChat is a plugin for WeeChat that enables it to connect to the Tox network. It is functional, but currently only intended for experimental use.

Current build status: Build Status

Installation

Tox-WeeChat is available in the AUR.

Tox-WeeChat requires WeeChat >= 1.0 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
$ 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 automatically load, 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 -list tox to get a list of all available commands.

TODO

  • Persist data (friend requests etc.)
  • Support encrypted save files
  • Tox DNS
  • Group chats
  • Support proxies (e.g. TOR)
  • A/V

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