https://github.com/tgalal/yowsup-docker

Dockerfile for yowsup
https://github.com/tgalal/yowsup-docker

Last synced: 7 days ago
JSON representation

Dockerfile for yowsup

• Host: GitHub
• URL: https://github.com/tgalal/yowsup-docker
• Owner: tgalal
• Created: 2015-06-24T18:46:57.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2020-06-05T10:10:12.000Z (over 4 years ago)
• Last Synced: 2024-08-06T03:01:53.452Z (3 months ago)
• Size: 4.88 KB
• Stars: 32
• Watchers: 8
• Forks: 23
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[yowsup](https://github.com/tgalal/yowsup) is a python library that implements WhatsApp's protocol. Through this docker image you are able to access yowsup's command line client and run different commands such as sending messages, creating groups, updating profile and many other things.

#Installation

```docker pull tgalal/yowsup```

#usage

Add ```--debug``` to any of the commands to get an insight on the actual protocol and see all incoming and outgoing data in your console.

yowsup will need access to a persistent storage to store generated keys data inside, used at registration and for login with e2e encryption enabled to work. Therefore you'll need to mount a host dir at /root/.yowsup in each docker run command.

##Registration

### Step 1 request code

```

docker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --requestcode sms

```

or

```

docker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --requestcode voice

```

note that the phone number must also begin with the specified country code

### Step 2 verify code

```

docker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --register CODE

```

Save the returned password as you will need it for login

##Clients

### Command line client

	

```

docker run -v SOMEDIR:/root/.yowsup -it tgalal/yowsup demos --login PHONE:PASSWORD --yowsup

```

This will start yowsup shell, type /L to login

```

Yowsup Cli client

==================

Type /help for available commands

\[offline]: /L

```

### Echo client

This echoes back all received messages

```

docker run -v SOMEDIR:/root/.yowsup tgalal/yowsup demos --login PHONE:PASSWORD --echo

```

### One shot client

Login, send a message, exit

```

docker run -v SOMEDIR:/root/.yowsup tgalal/yowsup demos --login PHONE:PASSWORD --send CONTACT_PHONE MESSAGE

```

## E2E encryption

To use e2e encryption in any of the clients, pass --moxie in any of the commands. For example:

```

docker run -v SOMEDIR:/root/.yowsup -it tgalal/yowsup demos --login PHONE:PASSWORD --yowsup --moxie

```