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
158 Commits 1 Branch 0 Tags 676 KiB
C 96.5%
CMake 2.1%
Python 1.2%
Shell 0.2%
9a97a3fe0c
Go to file
Håvard Pettersson 9a97a3fe0c sd.
2014-10-05 00:28:47 +02:00
src sd. 2014-10-05 00:28:47 +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 Wrote group chat invite code. 2014-10-04 21:42:30 +02:00
LICENSE Changed license to GPL3. 2014-09-18 18:56:43 +02:00
README.md Added SQLite persistent storage for friend requests. 2014-10-04 20:12:56 +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 (e.g. user@toxme.se) and group chats.

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.

TODO

  • Persist data (friend requests etc.)
  • Support encrypted save files
  • Tox DNS
  • Group chats
  • Support proxies (e.g. TOR)
  • Support WeeChat /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/.