Need help with whatsapp-play?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

295 Stars 226 Forks MIT License 504 Commits 21 Opened issues


Command line software through which you can play with your WhatsApp. It is having different options to play with your WhatsApp like message blast, online tracking, whatsapp chat..

Services available


Need anything else?

Contributors list

Downloads Codacy Badge PyPi CircleCI Docker Build Status codecov twitter HitCount Gitter Gitpod Ready-to-Code

It is a command line software through which you can play with your WhatsApp. It has different options to play with your WhatsApp, like message blast, online tracking, whatsapp chat. This software aims to provide all the facilities to use and implement a multitude of WhatsApp features. This CLI software does not require any API key for the execution.

online_tracker tracks the online and offline timings of your WhatsApp contact. It will check the online status and will immediately store that data into a .txt file. In order to make this work, make sure your Whatsapp language is set to English. Blog link:

terminal_chat stands for WhatsApp chat. Through this you can chat with your WhatsApp contact directly from the command line. Initially, recent chat is displayed and then the last received message is displayed every time you send a message. The chatbot gets activated when the target sends commands starting with /.Send /help command to see usage.

chat_intermediator lets you be an intermediator between two people.

message_service is a substitute for the API; it allows you to communicate your programs to wplay. You can modify our file messages.json with the number and message and the service will read the JSON and send the message. Check Wiki Usage for details.

telegram_bot sends the tracking status to our telegram bot.

message_blast is a message bomb script. It sends messages to your WhatsApp contact continously. The number of messages is decided by you. You can blast infinite number of messages to your WhatsApp contact.

message_timer is a message timer script. It sends messages to your WhatsApp contact from time to time. The number of messages and type of messages is decided by you. It's possible to send messages at random intervals, with the message type chosen randomly.

save_chat is a script to save the chat of the particular target.

schedule_message is a script to send message at a schedule time.

about_changer lets you create a customizable about you section for your profile, or, lets you change the about section of your profile according to lastest headlines.

get_news is a script to get all types of news in your whatsapp group. Visit to get your own API key and paste it in newsapi = NewsApiClient(api_key="YOUR API KEY")

getprofilephotos is a script to download profile photos of all the contacts in your whatsapp contact list.

broadcast_message is a script to allow the terminal to send a broadcast message to all the selected target persons.

target_info is a script to get information about the target user's contact number like Location (Country & City/Area), Carrier and Timezone.

download_media is a script to download all the media present in the target user's chat.


Install whatsapp-play from PyPI:


python -m pip install wplay

python3 -m pip install wplay

Installation Video: Simple Installation Link

Alternate way - Run whatsapp-play from source code:


$ git clone
$ cd whatsapp-play
$ python -m pip install -r requirements.txt
$ python -m wplay -h


$ git clone
$ cd whatsapp-play
$ python3 -m pip install -r requirements.txt
$ python3 -m wplay -h


For detailed usage of command visit:


The easiest way to contribute to Whatsapp-Play is by starring the repository and opening more and more issues for features you'd like to see in future.

First step is to create a fork and clone, then you can solve the issues listed and help us find new ones. Then try debugging with Visual Studio Code it is necessary to create a launcher with the arguments.

Steps to create a launcher with arguments follow the steps bellow:
1. Click in 'Debug' tab 1. Click in 'Add Configuration' 1. Select 'Module' 1. Type 'wplay' and press Enter 1. A json file will be opened. Inside configurations add the args, for example: "args":["-wb","name"]

Debug Tutorial Video: Debug Tutorial Link
Check more about contribution guidelines here


This software is for educational purpose only. Keeping eye on a innocent person can make person's life stressful.



If you like the project, support us by star

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.