====== yowsup ======

>yowsup is a python library that enables building applications that can communicate with WhatsApp users. The project started as the protocol engine behind Wazapp for Meego and OpenWA for BB10. Now as a standalone library it can be used to power any custom WhatsApp client.
[[https://github.com/tgalal/yowsup|https://github.com/tgalal/yowsup]]

===== Installation =====

==== Requirements ====

- %%python>=2.7,<=3.7%%\\
- %%consonance==0.1.3-1%%\\
- %%python-axolotl==0.2.2%%\\
- %%protobuf>=3.6.0%%\\
- %%six==1.10%%\\

==== yowsup-cli ====

Clone the git repository and execute the setup
<code>git clone https://github.com/tgalal/yowsup.git
cd yowsup-master/
./setup.py install</code>


===== Configuration =====

FIXME

==== Registration ====

**WARNING**

>It seems that recently yowsup gets detected during registration resulting in an instant ban for your number right after registering with the code you receive by sms/voice. I'd strongly recommend to not attempt registration through yowsup until I look further into this. Follow the status of this [[https://github.com/tgalal/yowsup/issues/2829|here]]

Example:
<code>
yowsup-cli registration --requestcode sms --config-phone 49XXXXXXXX --config-cc 49 --config-mcc 123 --config-mnc 456
yowsup-cli registration --register 123456 --config-phone 49XXXXXXXX
</code>

===== Usage =====

FIXME

===== Good to know =====

FIXME
<code>
CountryCode => Germany = 49
--config-cc 49

Mobile Country Code => Germany = 262
--config-mcc 262

Mobile Network Codes
--config-mnc 03
Most likely 01 - 03
01 	Telekom 	Telekom Deutschland GmbH 	
02 	Vodafone 	Vodafone D2 GmbH 	
03 	O2 	        Telefónica Germany GmbH & Co. oHG

Freenet / Klarmobil => 03
Freenet Funk => 07?!
0157 => Eplus => 03
</code>
[[https://en.wikipedia.org/wiki/Mobile_Network_Codes_in_ITU_region_2xx_(Europe)#Germany_%E2%80%93_DE|Wikipedia -
Mobile Network Codes]]\\
[[https://de.wikipedia.org/wiki/Mobilfunknetzkennzahl|Wikipedia - Mobilfunknetzkennzahl]]