!! Please use tgalal's original repository. All the latest changes are and will be applied there. https://github.com/tgalal/yowsup
If you need any assistance join our Discord server: https://discord.gg/Wa7QSxZ
Donate to tgalal the creator of this project:
Donate to me:
Yowsup is a Python library that enables you to build applications which use the WhatsApp service. Yowsup has been used to create two clients: 1) An unofficial WhatsApp client Nokia N9 through the Wazapp project which was in use by more than 200K users; 2) Another fully featured unofficial client for Blackberry 10.
- yowsup's architecture
- Create a sample app
- yowsup-cli
- Yowsup development, debugging, maintainance and sanity
- Requires python3.0 + (python2.6 + no longer support)
- Required python packages: python-dateutil, libmagickwand-dev
- Required python packages for end-to-end encryption: protobuf, pycrypto, python-axolotl-curve25519
- Required python packages for yowsup-cli: argparse, readline (or pyreadline for windows), pillow (for sending images)
Install using setup.py to pull all python dependencies
You need to have installed Python headers (probably from python-dev package) and ncurses-dev, then run
python3 setup.py install
Because of a bug with python-dateutil package you might get permission error for some dateutil file called requires.txt when you use yowsup (see this bug report) to fix you'll need to chmod 644 that file.
python setup.py install
Administrators privileges might be required, if so then run with 'sudo'
- Install mingw compiler
- Add mingw to your PATH
- In PYTHONPATH\Lib\distutils create a file called distutils.cfg and add these lines:
[build]
compiler=mingw32
- Install gcc:
mingw-get.exe install gcc - Install zlib
python setup.py install
If pycrypto fails to install with some "chmod error". You can install from:
https://github.com/axper/python3-pycrypto-windows-installer
and then rerun the install command again
Special thanks to:
and everyone else on the WhatsAPI project for their contributions to yowsup and the amazing effort they put into WhatsAPI, the PHP WhatsApp library
Special thanks goes to all other people who use and contribute to the library as well.
Please read this if you'd like to contribute to yowsup 2.0
Thanks!
As of January 1, 2015 yowsup is licensed under the GPLv3+: http://www.gnu.org/licenses/gpl-3.0.html.