pywhatkit 5.0

PyWhatKit is a Python library for Sending whatsapp message at certain time, it has several other features too.

PyWhatKit is a Python library with various helpful features. It is an easy to use library which does not requires you to do some additional setup.

Links

• Join our discord server - https://discord.gg/uwznv4jKgk

• Help us test an upcoming feature - Here

• Detailed documentation - Wiki

Installation

This library can be installed by the pip command, open your command prompt and type in the following command...

pip3 install pywhatkit

Functions of this library

First import the library using the command import pywhatkit as kit and then proceed to call the functions:

kit.sendwhats_image(...)

This function can be used to send Image or Gif or videos to anyone

The parameters are

phone_no (required) - Phone number of target with country code

img_path (required) - Path to image or gif or video

caption (required) - The text that should appear below images

wait_time (optional, val = 15) - Seconds after which the message will be sent after opening the web

kit.sendwhatmsg(...)

This function can be used to send WhatsApp message at certain time, kit.sendwhatmsg_instantly(...) can be used to send message instantly while kit.sendwhatmsg_to_group(...) can be used to send message to group.

The parameters are

phone_num (required) - Phone number of target with country code
message (required) - Message that you want to sendwhatmsg
time_hour (required) - Hours at which you want to send message in 24 hour format
time_min (required) - Minutes at which you want to send message
wait_time (optional, val = 20) - Seconds after which the message will be sent after opening the web
print_wait_time (optional, val = True) - Will print the remaining time if set to true
tab_close (optional, val = False) - True if you want to close the tab after sending the message

Some common errors

CountryCodeException - Check if the phone number passed into the parameter has country code
Message not getting delivered - Check internet speed and increase wait_time to 30 or above
CallTimeException - The web takes some time to load so some delay is required, make sure the seconds left is greater than the wait_time
SyntaxError - Make sure the first two parameters are string and the rest are int

kit.playonyt(...)

This function can be used to search and play a particular video on YouTube by using just the keyword, like "Shape of You song".

The parameters are

topic (required) - Topic or title that is related to the video.
use_api (optional, val = False) - Use web-API instead.
open_video (optional, val = True) - Opens video in your browser if set to True.

Some common errors

Video not opening - Make sure the topic exists or you have provided proper spelling, set use_api to True.

kit.search(...)

This function can be used to make a google search for any term.

The parameters are

topic (required) - Topic or title that you want to search

kit.info(...)

This function can be used to fetch information about any topic.

The parameters are

topic (required) - Topic or title that you want to get information about
lines (optional, val = 3) - Number of lines that you want to print about it
return_value (optional, val = False) - True if you want to return the result

Some common errors

Not returning paragraph - Make sure the topic exists and you are providing specific title

kit.image_to_ascii_art(...)

This function can be used to convert any image to ASCII art.

The parameters are

imgpath (required) - Path to the image that you want to convert
output_file (optional, val = "pywhatkit_asciiart.txt") - File where you want to save the output characters

Some common errors

File not found - Make sure that the path of the image is valid

kit.text_to_handwriting(...)

This function can be used to convert text to hand written characters, the character sets has been written by me.

The parameters are

string (required) - String that you want to convert to handwritten text
save_to (optional, save_to = "pywhatkit.png") - Path where the image will be saved
rgb (optional, val = (0,0,138)) - Color of the handwritten character in rgb format

Some Other Functions

pywhatkit.show_history() # Will show information of all the messages sent using this library

pywhatkit.shutdown(time=100) # Will shutdown the system

pywhatkit.cancel_shutdown() # Will cancel the scheduled shutdown

pywhatkit.tutorial_hindi/english() # Will open a tutorial on how to use this library on YouTube in respective language

pywhatkit.join_discord() # Will redirect you to our Discord server

pywhatkit.help.<function>() # For more information about a function

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. For more detailed information see this.

License

MIT