2013-05-31 18:50:58 +00:00
|
|
|
# transWhat
|
|
|
|
|
2015-09-07 14:32:08 +00:00
|
|
|
transWhat is a WhatsApp XMPP Gateway based on [Spectrum 2](http://www.spectrum.im) and [Yowsup 2](https://github.com/tgalal/yowsup).
|
2013-08-02 00:14:52 +00:00
|
|
|
|
2015-11-25 19:02:26 +00:00
|
|
|
## Getting started
|
|
|
|
|
|
|
|
I assume that you have a basic understanding of XMPP and the transport concept.
|
|
|
|
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.
|
|
|
|
I am using Prosody for this.
|
|
|
|
|
|
|
|
After this we have to install several dependencies:
|
|
|
|
|
|
|
|
### Dependencies
|
2013-08-02 00:14:52 +00:00
|
|
|
|
2015-09-07 14:32:08 +00:00
|
|
|
#### Python packages
|
2013-08-02 00:18:04 +00:00
|
|
|
|
2015-11-25 19:02:26 +00:00
|
|
|
pip install --pre e4u protobuf mysql dateutil
|
2013-08-02 00:18:04 +00:00
|
|
|
|
2015-09-07 14:32:08 +00:00
|
|
|
- **e4u**: is a simple emoji4unicode python bindings
|
2015-09-08 10:39:49 +00:00
|
|
|
- [**yowsup**](https://github.com/tgalal/yowsup): is a python library that enables you build application which use WhatsApp service.
|
2015-09-07 14:32:08 +00:00
|
|
|
- **mysqldb**: MySQL client python bindings
|
2013-08-02 00:18:04 +00:00
|
|
|
|
2015-09-07 14:32:08 +00:00
|
|
|
#### Spectrum 2
|
2015-02-26 18:58:25 +00:00
|
|
|
|
2015-11-25 19:02:26 +00:00
|
|
|
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.
|
|
|
|
|
|
|
|
### Installation
|
|
|
|
|
|
|
|
git clone git@github.com:stv0g/transwhat.git
|
|
|
|
|
|
|
|
### Configuration of Prosody
|
|
|
|
|
|
|
|
http://prosody.im/doc/components
|
|
|
|
|
|
|
|
### Configuration of Spectrum
|
|
|
|
|
|
|
|
### Configuration of transWhat
|
2015-02-26 18:58:25 +00:00
|
|
|
|
2015-09-07 14:37:59 +00:00
|
|
|
## Contributors
|
2013-08-02 00:14:52 +00:00
|
|
|
|
2015-09-07 14:37:59 +00:00
|
|
|
Pull requests, bug reports etc. are welcome. Help us to provide a open implementation of the WhatsApp protocol.
|
|
|
|
|
|
|
|
The following persons have contributed major parts of this code:
|
|
|
|
|
|
|
|
- **Steffen Vogel** (@stv0g): Idea and initial implementation based on Yowsup 1
|
|
|
|
- **Mohammed Yaseen Mowzer** (@moyamo): Port to Yowsup 2
|
2013-08-02 00:14:52 +00:00
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
2015-09-08 10:37:39 +00:00
|
|
|
A project wiki is available [here](https://dev.0l.de/wiki/projects/transwhat/).
|
2013-08-02 00:14:52 +00:00
|
|
|
|
2015-09-07 14:32:08 +00:00
|
|
|
An *outdated* writeup of this project is also availabe at my [blog](http://www.steffenvogel.de/2013/06/29/transwhat/).
|