NAME
  yowsup-cli - command line tool that acts as WhatsApp client
SYNOPSIS
  yowsup-cli [-h]
             [-l | -s <phone> <message> | -i <phone> | -b <jids> <message>]
             [-w] [-a] [-k] [-r (sms|voice) | -R <code> | -e]
             [--sync <numbers>]
             [--generatepassword <input> | --decodestring <encoded_array>]
             [--help-config] [-c <file>] [--ignorecached] [-d] [-v]
DESCRIPTION
  yowsup-cli is a command line program, based in python-yowsup library, that
  allows you to login and use the WhatsApp service, providing all capabilities
  of an official WhatsApp client, as encryption of messages.
OPTIONS
  General and optional arguments:
    -h, --help  Show this help message and exit.
    --help-config  Display info about configuration format.
    -c <file>, --config <file>  Path to config file containing authentication info.
                                The default configuration file is ~/.yowsup/auth. The '-c' option
                                can be used to load another configuration file. For more info about config format use --help-config.
    --ignorecached  Don't use cached token if exists.
    -d, --debug  Enable debug messages.
    -v, --version  Print version info and exit.

  Client options:
    -l, --listen  Listen to messages.
    -s <phone> <message>, --send <phone> <message>   Send message to phone number and close connection.
                        Phone is full number including country code, without '+' or '00'.
    -i <phone>, --interactive <phone>  Start an interactive conversation with a contact.
                        Phone is full number including country code, without '+' or '00'.
    -b <jids> <message>, --broadcast <jids> <message>  Broadcast message to multiple recepients, comma separated.
    -w, --wait  If used with -s, then connection will not close until server confirms reception of the message.
    -a, --autoack  If used with -l or -i, then a message received ack would be automatically sent for received messages.
    -k, --keepalive  When used with -l or -i, Yowsup will automatically
                     respond to server's ping requests to keep connection alive.

  Registration options:
    -r (sms|voice), --requestcode (sms|voice)  Request the registration code from WhatsApp.
    -R <code>, --register <code>  Register account on WhatsApp using the provided code.
    -e, --exists  Check if account credentials are valid. WARNING:
                  WhatsApp now changes your password everytime you use
                  this. Make sure you update your config file if the
                  output informs about a password change.

  Contacts options:
    --sync <numbers>  Sync provided numbers. Numbers should be comma-separated. If a number is not in international format,
                        WhatsApp will assume your own country code for it.
                        Returned data indicate which numbers are WhatsApp
                        users and which are not. For WhatsApp users, it will
                        return some info about each user, like user status.

  Debug tools:
    --generatepassword <input>  Generate password from given string in same way
                              WhatsApp generates it from a given IMEI or MAC Address.
    --decodestring <encoded_array>  Decode byte arrays found in decompiled version of
                                  WhatsApp. Tested with S40 version. Input should be
                                  comma separated without the enclosing brackets.

CONFIGURATION FILE
  A configuration file, known as login credentials, must be provided to yowsup-cli. The default configuration file
  is ~/.yowsup/auth. However, you can provide another file using '-c' option.

  WhatsApp protocol is basically a modified version of XMPP. It uses JID and password for login.
  The JID is the phone number registered with, which is a combination of the country code and the phone number.
  In older versions of WhatsApp, the password was generated from phone IMEI in case of Nokia or Android, or from
  phone Wlan MAC Address in case of iOS. yowsup-cli is able to generate the same exact password used by your
  phone's WhatsApp client for login, which makes you able to login using yowsup-cli and send and receive messages
  without affecting your WhatsApp's setup on phone. You should save these info in a text file (default is ~/.yowsup/auth),
  in the following format:

    cc=55
    phone=556101234567
    id=
    password=

  The line 'cc=' must be filled with the country code.

  The 'phone=' field will be composed by 'country code' + 'area code' + 'phone number'. In the current example was used 55 (country = Brazil) +
  61 (area code = Brasilia) + 01234567 (phone number). The country code must be provided without '+' or '00' leading.

  The 'id=' field is used in registration calls (-r|-R|-e) and for login, if you are trying to use an existing account that is setup on a physical device
  (a mobile phone or other device). WhatsApp has recently deprecated using IMEI/MAC to generate the account's password in updated versions of their clients.
  Use '--v1' switch to try it anyway. Typically this field should contain the phone's IMEI if your account is setup on a Nokia or an Android device, or the
  phone's WLAN's MAC Address for iOS devices. If you are not trying to use existing credentials, you can leave this field blank or remove it.

  Finally, the 'password=' has the login password. This password will be gotten when you register the phone number using yowsup-cli. See the
  REGISTERING A NUMBER section. If you are registering a number, you can leave this field blank.

  Is recommended set a permission '600' to configuration file.

REGISTERING A NUMBER

  Registration is done through two steps, similar to how it works on official WhatsApp clients. First you request a registration code from WhatsApp (you must
  have a configuration file to this):

    yowsup-cli \-\-requestcode sms

  The command will show something similar to:

    status: sent
    retry_after: 1805
    length: 6
    method: sms

  After this, the code will then be delivered to your mobile phone number via your preferred method (SMS/voice). Once you have obtained the code, you proceed
  with the second step, which is to send that code using '--register' argument. This example will consider the received code as being 123-456:

    yowsup-cli \-\-register 123-456

  After the last command, you will see something similar to:

    status: ok
    kind: free
    pw: 1coGO6bwjT8Uukw9qa8v3ql2KXM=
    price: US$0.99
    price_expiration: 1407002374
    currency: USD
    cost: 0.99
    expiration: 1435773701
    login: 556101234567
    type: new

  If you successfully register, WhatsApp will generate a password for your which will be displayed in the command output (see the 'pw:' line). You MUST
  MANUALLY store this password in the same config file you are registered with. See an example:

    cc=55
    phone=556101234567
    id=
    password=1coGO6bwjT8Uukw9qa8v3ql2KXM=

EXAMPLES
  Send a simple message to +0055 11 190102030  $ yowsup-cli -s 551190102030 "Testing WhatsApp..."

  Send a simple message to +0055 11 190102030, using an alternative configuration file  $ yowsup-cli -s 551190102030 "Testing WhatsApp..." -c /path/conf.test

  Start the interactive mode (chat) to talk with +0055 11 190102030  $ yowsup-cli -i 55111190102030

  Decode byte arrays  $ yowsup-cli --decodestring 112,61,100,123,114,103,96,114,99,99,61,125,118,103

SEE ALSO
  sendxmpp(1)

AUTHOR
  yowsup-cli was developed by Tarek Galal <tare2.galal@gmail.com>.

  This manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org> for the Debian project (but may be used by others).
