Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tgalal/yowsup
The WhatsApp lib
https://github.com/tgalal/yowsup
Last synced: about 2 months ago
JSON representation
The WhatsApp lib
- Host: GitHub
- URL: https://github.com/tgalal/yowsup
- Owner: tgalal
- License: gpl-3.0
- Created: 2012-11-03T19:00:14.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T16:49:08.000Z (4 months ago)
- Last Synced: 2024-07-18T02:47:47.206Z (2 months ago)
- Language: Python
- Homepage:
- Size: 1.9 MB
- Stars: 7,025
- Watchers: 471
- Forks: 2,227
- Open Issues: 469
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- starred-awesome - yowsup - The python WhatsApp library (Python)
README
# yowsup [](https://travis-ci.org/tgalal/yowsup)
**For private consultancy feel free to directly schedule it over [codementor](https://www.codementor.io/@tgalal).**
---
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](https://wiki.maemo.org/Wazapp) and
[OpenWA for BB10](https://www.lowyat.net/2013/5896/try-this-openwhatsapp-for-blackberry-10/). Now as a standalone
library it can be used to power any custom WhatsApp client.
```
updated: 2021-12-14
yowsup version: 3.3.0
yowsup-cli version: 3.2.1
requires:
- python>=2.7,<=3.7
- consonance==0.1.5
- python-axolotl==0.2.2
- protobuf>=3.6.0
- six==1.10
uses:
- argparse [yowsup-cli]
- readline [yowsup-cli]
- pillow [send images]
- tqdm [mediasink demo]
- requests [mediasink demo]
```
## See also
During maintenance of yowsup, several projects have been spawned in order to support different features that get
introduced by WhatsApp. Some of those features are not necessarily exclusive to WhatsApp and therefore it only made
sense to maintain some parts as standalone projects:
- [python-axolotl](https://github.com/tgalal/python-axolotl): Python port of
[libsignal-protocol-java](https://github.com/signalapp/libsignal-protocol-java), providing E2E encryption
- [consonance](https://github.com/tgalal/consonance/): WhatsApp's handshake implementation using Noise Protocol
- [dissononce](https://github.com/tgalal/dissononce): A python implementation for
[Noise Protocol Framework](https://noiseprotocol.org/)
## Quickstart
* **[Installation](#installation)**
* **[yowsup's architecture](https://github.com/tgalal/yowsup/wiki/Architecture)**
* **[Create a sample app](https://github.com/tgalal/yowsup/wiki/Sample-Application)**
* **[yowsup-cli](https://github.com/tgalal/yowsup/wiki/yowsup-cli)**
## Installation
Install using setup.py to pull all Python dependencies, or pip:
```
pip install yowsup
```
### Linux
You need to have installed Python headers (probably from python-dev package) and ncurses-dev, then run
```
python setup.py install
```
### FreeBSD (*BSD)
You need to have installed: py27-pip-7.1.2(+), py27-sqlite3-2.7.11_7(+), then run
```
pip install yowsup
```
### Mac OS
```
python setup.py install
```
Administrators privileges might be required, if so then run with 'sudo'
### Windows
- Install [mingw](http://www.mingw.org/) 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](http://www.zlib.net/)
- ```python setup.py install```
# License:
As of January 1, 2015 yowsup is licensed under the GPLv3+: http://www.gnu.org/licenses/gpl-3.0.html.