added transwhat and spectrum example confirmations
This commit is contained in:
Steffen Vogel
parent
0421df20a3
commit
5c90783bc4
107
README.md
107
README.md
|
|
@ -4,47 +4,102 @@ transWhat is a WhatsApp XMPP Gateway based on [Spectrum 2](http://www.spectrum.i
|
||||||
|
|
||||||
## Getting started
|
## Getting started
|
||||||
|
|
||||||
I assume that you have a basic understanding of XMPP and the transport concept.
|
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. It is based on the Spectrum 2 XMPP transport framework and the Yowsup 2 library to interface with WhatsApp.
|
|
||||||
|
|
||||||
Before getting started, please make sure that you have a XMPP server running.
|
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).
|
||||||
I am using Prosody for this.
|
|
||||||
|
|
||||||
After this we have to install several dependencies:
|
The implementation of transWhat is based on the [Spectrum 2](http://www.spectrum.im) framework and the [Yowsup 2](https://github.com/tgalal/yowsup) library to interface with WhatsApp.
|
||||||
|
|
||||||
### Dependencies
|
The following chart summarizes the involved components and the protocols they use to communicate.
|
||||||
|
|
||||||
#### Python packages
|
### Prosody
|
||||||
|
|
||||||
pip install --pre e4u protobuf mysql python-dateutil
|
##### 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](https://github.com/hanzz/libtransport).
|
||||||
|
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 mysql python-dateutil
|
||||||
|
|
||||||
- **e4u**: is a simple emoji4unicode python bindings
|
- **e4u**: is a simple emoji4unicode python bindings
|
||||||
- [**yowsup**](https://github.com/tgalal/yowsup): is a python library that enables you build application which use WhatsApp service.
|
- [**yowsup**](https://github.com/tgalal/yowsup): is a python library that enables you build application which use WhatsApp service.
|
||||||
- **mysqldb**: MySQL client python bindings
|
- **mysqldb**: MySQL client python bindings
|
||||||
|
|
||||||
#### Spectrum 2
|
##### Configuration
|
||||||
|
|
||||||
Manual compile latest version from [Github](https://github.com/hanzz/libtransport).
|
First create a new mySQL database named `transwhat` and fill it with the [schema](https://raw.githubusercontent.com/stv0g/transwhat/yowsup-2/conf/schema.sql) provided in the repo.
|
||||||
You can use the following guide: http://spectrum.im/documentation/installation/from_source_code.html.
|
|
||||||
|
|
||||||
### Installation
|
Then create a new file called `constants.py` in the newly checked out transWhat Git repository:
|
||||||
|
|
||||||
git clone git@github.com:stv0g/transwhat.git
|
DB_HOST = "localhost"
|
||||||
|
DB_USER = "**fillin**"
|
||||||
|
DB_PASS = "**fillin**"
|
||||||
|
DB_TABLE = "transwhat"
|
||||||
|
|
||||||
### Configuration of Prosody
|
BASE_PATH = "/location/to/transwhat"
|
||||||
|
|
||||||
See http://prosody.im/doc/components.
|
TOKEN_FILE = BASE_PATH + "/logs/tokens"
|
||||||
|
MOTD_FILE = BASE_PATH + "/conf/motd"
|
||||||
Component "whatsapp.0l.de"
|
REQUESTS_FILE = BASE_PATH + "/logs/requests"
|
||||||
component_secret = "whatsappsucks"
|
|
||||||
component_ports = { 5221 }
|
|
||||||
component_interface = "127.0.0.1"
|
|
||||||
|
|
||||||
### Configuration of Spectrum
|
|
||||||
|
|
||||||
### Configuration of transWhat
|
|
||||||
|
|
||||||
First create a mySQL database named `transwhat` and fill it with the [schema](https://raw.githubusercontent.com/stv0g/transwhat/yowsup-2/conf/schema.sql) provided in the repo.
|
|
||||||
|
|
||||||
## Docker
|
## Docker
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue