transpub/INSTALL.md

Installation and configuration guide

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.

Prosody

Installation

I will not cover the installation of Prosody in this guide. Please look for some other tutorials on how to do that.

Configuration

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"

Spectrum 2

Installation

Manual compile latest version from Github. You can use the following guide: http://spectrum.im/documentation/installation/from_source_code.html.

Configuration

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 = /location/to/transwhat/transwhat.py

users_per_backend = 10
more_resources = 1

admin_jid = your@jid.example

[identity]
name = transWhat
type = xmpp
category = gateway

[logging]
config = /etc/spectrum2/logging.cfg
backend_config = /etc/spectrum2/backend-logging.cfg

transWhat

Installation

Checkout the latest version of transWhat from GitHub:

$ git clone git@github.com:stv0g/transwhat.git

Install required dependencies:

$ pip install --pre e4u protobuf python-dateutil

• e4u: is a simple emoji4unicode python bindings
• yowsup: is a python library that enables you build application which use WhatsApp service.

Configuration

Then create a new file called constants.py in the newly checked out transWhat Git repository:

BASE_PATH = "/location/to/transwhat"

TOKEN_FILE = BASE_PATH + "/logs/tokens"
MOTD_FILE = BASE_PATH + "/conf/motd"
REQUESTS_FILE = BASE_PATH + "/logs/requests"