tox-weechat/README.md

76 lines
3.0 KiB
Markdown
Raw Normal View History

2014-09-02 18:54:42 +00:00
Tox-WeeChat
===========
2014-10-11 08:32:11 +00:00
Tox-WeeChat is a [Tox][1] protocol plugin for [WeeChat][2]. It is functional, but lacks certain features like Tox DNS.
2014-09-02 18:54:42 +00:00
2014-09-30 18:40:24 +00:00
Current build status: [![Build Status](https://travis-ci.org/haavardp/tox-weechat.svg?branch=master)][3]
2014-09-02 20:38:30 +00:00
2014-09-02 18:54:42 +00:00
Installation
------------
2014-10-14 19:41:47 +00:00
> Tox-WeeChat is available in the [AUR][4] and the [[haavard]][5] pacman repository.
2014-09-18 17:39:40 +00:00
2014-10-14 19:41:47 +00:00
Tox-WeeChat requires [WeeChat][1] >= 1.0.1, [SQLite][6] >= 3.6.19 and the latest-ish [libtoxcore][7]. It also requires CMake to be built. Installation is fairly simple; after getting the source, compile and install using CMake:
2014-09-02 18:54:42 +00:00
$ mkdir build && cd build
2014-10-11 11:16:18 +00:00
$ cmake -DPLUGIN_PATH=~/.weechat/plugins ..
2014-09-11 02:06:20 +00:00
$ make install
2014-10-11 11:16:18 +00:00
This installs the plugin binary `tox.so` to the recommended location `~/.weechat/plugins`. The default location is `/usr/local/lib/weechat/plugins`.
2014-09-02 18:54:42 +00:00
Usage
-----
2014-09-30 18:40:24 +00:00
- 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.
2014-09-28 01:29:34 +00:00
- 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>`.
2014-09-17 15:49:12 +00:00
- Change your name with `/name <new name>`.
2014-09-19 15:53:11 +00:00
- Get your Tox ID with `/myid`.
2014-09-02 18:54:42 +00:00
- To add friends or respond to friend requests, `/help friend` will get you started.
2014-09-17 15:49:12 +00:00
- Message a friend with `/msg <friend number>`. Get their friend number with `/friend list`.
2014-09-02 18:54:42 +00:00
2014-10-11 11:16:18 +00:00
Run `/help -listfull tox` to get a list of all available commands, and `/set tox.*` for a list of options.
2014-09-02 18:54:42 +00:00
2014-10-08 09:51:50 +00:00
### Common issues
2014-10-08 09:51:50 +00:00
#### Long Tox names messing up WeeChat layout
Tox allows names up to 128 bytes long. To prevent long names from taking all your screen space, you can set the following options in WeeChat:
- `weechat.bar.nicklist.size_max`
- `weechat.look.prefix_align_max`
- `buffers.look.name_size_max` (if using buffers.pl)
2014-10-11 11:16:18 +00:00
#### Tox won't connect through my proxy
Make sure the address and port is correct, and that UDP is disabled (`/set tox.profile.*.udp`).
2014-09-28 01:29:34 +00:00
TODO
2014-09-10 22:29:09 +00:00
----
2014-10-08 09:51:50 +00:00
- Tox DNS
- Encrypted save files
2014-10-05 01:36:14 +00:00
- WeeChat's `/upgrade`
2014-09-30 18:40:24 +00:00
- Audio/video chats
2014-09-10 22:29:09 +00:00
2014-09-02 18:54:42 +00:00
License
---------
2014-09-18 16:55:52 +00:00
Copyright (c) 2014 Håvard Pettersson <haavard.pettersson@gmail.com>
2014-09-02 18:54:42 +00:00
2014-09-18 16:55:52 +00:00
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/>.
2014-09-02 18:54:42 +00:00
2014-09-30 18:40:24 +00:00
[1]: http://tox.im
[2]: http://weechat.org
[3]: https://travis-ci.org/haavardp/tox-weechat
[4]: https://aur.archlinux.org/packages/tox-weechat-git
2014-10-14 19:41:47 +00:00
[5]: https://haavard.me/archlinux
[6]: http://www.sqlite.org
[7]: https://github.com/irungentoo/toxcore
2014-09-02 19:14:05 +00:00