Skip to content
tieum edited this page Sep 14, 2015 · 11 revisions

Welcome to the whatsapp-purple Wiki!

Installation instructions for Pidgin

Linux

If you're using Ubuntu, you can install the package from our official PPA. If you need help with adding PPAs on Ubuntu in order to get a repository, please check these instructions.

If you're using Arch Linux, there's also a package available in the AUR right here.

If you're looking for prebuilt binaries for other Linux distributions or you want to compile it yourself, check out the instructions currently available over here.

Windows

An easy way to get the plugin working is downloading a nightly build from this repository.

  • Download last-whatsapp.dll from the above link and place it in Pidgin's plugins folder. Its location depends on where you've installed Pidgin and might look something like C:\Program Files (x86)\Pidgin\plugins\.
  • Start/Restart pidgin
  • You do not need to enable the plugin in Pidgin's plugin menu. You can just go ahead and create a new account in Pidgin – the WhatsApp protocol should be available.

Login credentials

Username

Your username is your phone number including your Country Code, but without any leading zeros or +. If you don't know what your Country Code is, you can see a list here.

Example

Phone number: +49123456789 (or: 0049123456789)

WhatsApp username: 49123456789

Password

If you plan to register an account for a brand new number, please skip over to Setting up your account. If you want to retrieve the password for an already registered WhatsApp account on your mobile, make sure to read this section as well as Setting up your account.

iOS

Recent WhatsApp versions will generate a random password on the server-side. For a short (and yet unknown) period of time, WhatsApp will store this password on your mobile. If this period is exceeded, your password will only be stored in an encrypted format.

As for iOS users, the encrypted file is located at /var/mobile/Applications/{WhatsAppID}/Library/pw.dat. As of now (December 2013), there is no known method on how to decrypt this file to retrieve your password.

Instead, iOS users will need to re-register their mobile's account from their desktop (see Mobile and Pidgin), wait at least 30 minutes and then open up WhatsApp on your mobile. WhatsApp will then ask you to re-register your account for your mobile. Doing this will populate the database located at /var/mobile/Applications/{WhatsAppID}/Library/Caches/net.whatsapp.WhatsApp/Cache.db which will then contain your password in plain text for a short period of time.

If you're not sure about what your mobile's {WhatsAppID} is, you can use iFile on your jailbroken iPhone and make it display the application names instead of the IDs by configuring iFile's options. iFile is also capable of viewing SQLite databases, but the contents that iFile displays do not match the database file's actual contents (JSON data doesn't seem to be working in iFile yet). In order to view the database file's contents, you can use SQLiteStudio.

You should as well make sure that you do not only copy Cache.db to your local machine, but also any other file that starts with this string (e.g. Cache.db-shm or Cache.db-wal), since these are complementary to Cache.db and will automatically be recognized and read by SQLiteStudio.

In order to retrieve your password from this database, view the table cfurl_cache_receiver_data and look for a row whose content looks similar to the following:

{"status":"ok","login":"000000000","pw":"[this-garbage-is-your-password]","type":"existing","expiration":4444444444.0,"kind":"paid","price":"0,89 \u20ac","cost":"0.89","currency":"EUR","price_expiration":1365571100}

You can easily grab your password from this entry and use it for your desktop client (such as Pidgin). Make sure to backup your password since it seems to be available for only an unknown period of time.

Android

For Android you can find instructions here

Setting up your account

In order to get a WhatsApp account, there are two options:

  • Create a new account (with a brand new phone number)
  • Use a number which has already been used to log into WhatsApp

The first option is really easy and convenient, while the second bears some disadvantages. If you want to use WhatsApp with both Pidgin and your mobile client, the process is more complicated.

Pidgin only

In case you want to register a new phone or get the password for an already existing one (and thus, lose access on your phone), you can use a tool called WART. Just download the executable and follow the instructions on the website.

Mobile and Pidgin

If you want to use WhatsApp on your mobile and retrieve the password for using it with a desktop client such as Pidgin, you should check out projects such as MissVenom or Yowsup. MissVenom is able to get your password during the registration process on your phone. Yowsup allows you to register WhatsApp accounts over your console, retrieve your password during this registration process and also login to your WhatsApp account from your console granting you simple communication features. Please check the corresponding websites for more information and instructions.