Breakbot is a software that serves as gateway between several communication protocols.
It was started as a way to scratch one of the author's own itch, i.e. to break free from the walled garden that WhatsApp is, and to be able to use a proper computer with a proper screen and a proper keyboard (I hate long chats in tiny screens).
It currently supports:
Things it does not currently support:
Contact info is at the bottom of this document.
Breakbot is in early stages, lacks documentation everywhere, needs refactoring, may set fire to your computer, take your jobs... the usual drill. Just don't blame me for any problem it causes.
You'll need a WhatsApp account (phone number + password) that Breakbot will use.
Note that WhatsApp does not allow simultaneous connections, so you may want to get a secondary phone number for your Breakbot (e.g.: buy a second SIM card, or get a free number at fonyou, etc). Otherwise the bot would log you out of your phone's WhatsApp client.
You can register a WhatsApp account for your number without an actual physical phone, by following step #4 in the list below.
Note: all phone numbers must be specified as international number
without 00
or +
. E.g: Spanish number 600600600
would become 34600600600
Steps:
./get_libs.sh
.python Yowsup/yowsup-cli -h
.config.json
, go to config
section, and customize all the fields.
wa_password
is the base64-encoded password as returned by the --exists
option of yowsup-cliwa_phone
is the phone number used by the bot to connect to WhatsApp. See Requisites
above.irc_*
parameters are what you expect.bot_owner_nick
is the IRC nick of the bot owner (needed for private messaging).python bot.py
so that it connects to WhatsApp
NNN-NNN@g.us
. Those are the WhastApp group chats. Write them down somewhere.config.json
, go to contacts
section, and:
Just cross your fingers, run python bot.py
and wait for your bot to appear at the specified IRC channels (should take about 5-10 seconds with a proper connection).
Once connected, everything you say on IRC should appear on WhastApp and vice versa.
You can notify me about problems and feature requests at the issue tracker
Feel free to hack the code and send me GitHub pull requests, or traditional patches too; I'll be more than happy to merge them.
The author Bruno Gonzalez can be reached at stenyak@stenyak.com and /dev/null
for personal praise and insults, respectively.