README
author Dominik George <nik@naturalnet.de>
Mon, 04 Nov 2013 20:45:18 +0100
changeset 172 d33526eba590
parent 149 8c4129116d12
permissions -rw-r--r--
Fixed calls for MCabber API changes in 0.10.2.

mcabber-jingle is a set of modules implementing:
* Jingle (XEP-0166), a XMPP extension for managing peer-to-peer sessions
* Jingle File Transfer (XEP-0234), a Jingle application type for transferring
  files between two entities.
* Jingle In-Band Bytestreams (XEP-261), a Jingle transport method that sends data
  using the In-Band Bytestreams (IBB) protocol (XEP-0047).
  
====INSTALLATION====
To build the modules, you will need loudmouth and mcabber headers files along
with cmake. On Debian/Ubuntu, cmake is provided by the "cmake" package and the
loudmouth header files in "loudmouth-dev".
Once you have installed them, you can simply run "cmake .", then "make install"
as root. This should install the 3 modules in /usr/lib/mcabber.
To load them, type "/module load jingle", "/module load jingle-ft" and "module
load jingle-ibb". You can also load them automatically by putting those three
lines in your mcabberrc without the leading slash.

=======USAGE=======
The Jingle File Transfer module provide a /jft command.
This command has three modes:
* "send" to send files. e.g:
  /jft send /tmp/some_file_i_share
  Note that like in a shell, ~ refer to your home dir.
* "info" to list transfers.
* "flush" to remove finished transfers.