Skip to main content

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

Project description

logo

image image image image image image image image

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

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 image

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.

SendWhatMsg

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".

PlayonYT

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.

Search Google

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.

Wikipedia

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.

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.

Text to Handwriting

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pywhatkit, version 5.1
Filename, size File type Python version Upload date Hashes
Filename, size pywhatkit-5.1-py3-none-any.whl (12.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pywhatkit-5.1.tar.gz (12.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page