I assume that you have a basic understanding of XMPP and the the concept of a XMPP component/transport. If not, please get a book about Jabber or read the standards.
transWhat is a XMPP transport. By this means it extends the functionallity of an existing XMPP server. It acts as a gateway between the XMPP and WhatsApp networks. It receives WhatsApp messages and forwards them to your XMPP client (and vice-versa).
The implementation of transWhat is based on the Spectrum 2 framework and the Yowsup 2 library to interface with WhatsApp.
The following chart summarizes the involved components and the protocols they use to communicate.
I will not cover the installation of Prosody in this guide. Please look for some other tutorials on how to do that.
The only important thing for us is the configuration of a XMPP component (Spectrum 2 in our case). See http://prosody.im/doc/components.
Append the following at the end of /etc/prosody/prosody.cfg.lua
Component "whatsapp.0l.de"
component_secret = "whatsappsucks"
component_ports = { 5221 }
component_interface = "127.0.0.1"
Manual compile latest version from Github. You can use the following guide: http://spectrum.im/documentation/installation/from_source_code.html.
Create a new file /etc/spectrum2/transports/whatsapp.cfg with the
following content:
[service] user = spectrum group = spectrum jid = whatsapp.0l.de server = localhost password = whatsappsucks port = 5221 backend_host = localhost backend = /usr/bin/transwhat users_per_backend = 10 more_resources = 1 admin_jid = [email protected] [identity] name = transWhat type = xmpp category = gateway [logging] config = /etc/spectrum2/logging.cfg backend_config = /etc/spectrum2/backend-logging.cfg [database] type = sqlite3
Checkout the latest version of transWhat from GitHub:
$ git clone [email protected]:stv0g/transwhat.git
Install required dependencies:
$ pip install --pre e4u protobuf python-dateutil yowsup2