transpub/USAGE.md

2.4 KiB

Usage

Starting/stopping service

The transwhat.py script gets started as a backend by Spectrum. You should not try to run it manually. To simplify the management of multiple transports (WhatsApp, IRC, Facebook, libpurple, ...), Spectrum provides a little helper tool called spectrum_manager:

To start transwhat run

    spectrum_manager start whatsapp

To stop transwhat run

    spectrum_manager stop whatsapp

Bot

You might want to talk to bot if you're feeling lonely ;-P

The bot is one of the contacts every user has in its contact list. It offers you a simple way to interact with the server:

Command Description
\help show this message
\prune clear your buddylist
\sync sync your imported contacts with WhatsApp
\lastseen request last online timestamp from buddy
\leave permanently leave group chat
\groups print all attended groups
\getgroups get current groups from WA

All commands start with a backslash!

Login

To login to the transWhat, you should use the service discovery option in your XMPP client.

When asked about the login credentials, enter your data as described below:

Setting Value Example
User CountryCode + PhoneNumber 4917634911387
Password WhatsApp password Base64 string

Buddies

WhatsApp does not store your contacts on their servers. Thus you need to import your contacts manually with your XMPP Client or use .:bot to Import your contacts from Google (preferred).

(In Pidgin: Menu => Buddys => Add Buddy)

Just use the same JID format as for your login:

CountryCode + PhoneNumber + "@whatsapp.example.org"

Groups

To chat with groups you need to add them manually to your XMPP client.

To get a list of your WhatsApp groups, you can use the Auto Discovery functionality of your XMPP client.

(In Pidgin: Menu => Buddys => Join Chat => RoomList)

Smileys / Emojis

To be able to see smileys, you will need an Unicode Emoji font.

When using Pidgin, you might want to check out my stv0g's Unicode emoji theme].