Skip to main content

Autosel is a Python package that automates sending emails, Whatsapp text, images, videos, and audio messages along with other functionalities like creating a group and spam bot.

Project description

Autosel

Autosel is a Python package that automates sending emails, Whatsapp text, images, videos, and audio messages along with other functionalities like creating a group and spam bot.

Libraries Used: Selenium, gTTS
 


Main Features

  1.   Bolding Functionality in Emails
    • Specific Parts of an Email can now be bolded using autosel.
  2.   Spam Bot in Whatsapp
    • Using autosel, we can send a message multiple times (spam) to a user(s).
  3.   Audio Sender in Whatsapp
    • Text messages can now be sent as voice clip using autosel
  4.   automate sending all types of media in Whatsapp in Whatsapp
    • Using autosel, we can automate sending Text, Images, Videos, Documents, and Audio Clips.
  5.   Group Creator in Whatsapp
    • Process of creating a group and adding participants, and sending invites is automated by autosel

 


Table of Contents


Prerequisites

  • Chrome Driver
    Download the suitable version of your chrome driver from here which is similar to the version of your Chrome browser. The Chrome version can be found in Settings/About Chrome

  • Selenium

     pip install selenium
    
  • gTTs

    pip install gtts
    

Installation

  • Using PIP
    pip install autosel 
    
  • Using Conda
    conda install autosel
    

What Classes are present in this Library?

Email Class

A. Description

This Class automates the process of sending E-mails to multiple recipients. Using the sender_mail and sender_password credentials as input along with mail_subject and mail_body as input, Mails can be sent to Multiple recipients individually.

There's an additional functionality of Bolding the content in the body. This feature can be used by alternatively giving the texts in the mail_body list with normal and bold texts [ "Normal text1", "Bold Text 1", "Normal text 2", "Bold Text 2" ....]

Note:

  • To input Multiple lines of string, use triple quotes.
  • It is advised to use organization-specific sender_email that (or) gmail that aren't created on this device to avoid security issues with Google verification.

B. What Methods do we Offer?

C. Importing and assigning Email class

  • Importing the Email Class

    from autosel import Email
    
  • Assign Email Class to a Class Variable:
    The Email Sender Class takes inputs as sender_email, sender_password, mail_subject, mail_body

    The Bolding Functionality can be use in body of the Email by alternatively giving the texts in mail_body variable as shown below.
    [ "Normal text1", "Bold Text 1", "Normal text 2", "Bold Text 2" ....]

    Input Parameters:

    sender_email      : str, Mail ID of the sender
    sender_password : str, Password of the sender
    mail_subject      : str, Subject of the Email
    mail_body           : list, List of stings alternatively given with Normal and bolding texts.

    var = Email(sender_email= "abc@gmail.com", sender_password= "12345678", mail_subject= "Hello World!", mail_body= ["""This is a Normal Text, ""","""This is a Bolded Text"""])
    

D. Methods

  • send_mails

    This method automatically sends emails to the recipients.
    Mails can be sent to Multiple recipients individually by adding their names in the emails list.

    Input Parameters:

    driver_path: str, Chrome Driver Address.
    emails         : list, List of Emails to which emails are to be sent.

    var.send_mails(driver_path= "", emails= ["",""]) 
    

    Demo : To watch a quick demo, Click here


Whatsapp Class

A. Description

B. What Methods Do we have?

C. Importing and assigning Email class

  • Importing the Whatsapp Class

    from autosel import Whatsapp
    
  • Assign Whatsapp Class to a variable

    To initialize the chrome driver and to login got whatsapp. The usage_data_directory is used to store the QR code information to avoid multiple scanning.

    Input Parameters :

    driver_address           : str, Address of Chrome Driver.
    usage_data_directory : str, Stores data to help logging multiple times seamless by passing QR code.

    Code:

    var = Whatsapp(driver_address="", usage_data_directory= "")
    

D. Methods

  • spam_bot

    • This method is used to send repeated texts (Spam) to the same person.
    • Messages can be sent to Multiple recipients also by the contact names in name list.

    Input Parameters :

    name  : list, Names of the person to whom these messages are to be sent.
    msg    : str, Message.
    count : int, Number of Messages.

    Code :

    var.spam_bot(name= ["",""], msg= "", count=)
    

    Demo : To watch a quick demo, Click here


  • send_text

    • This method is used to automatically send messages to the recipient.
    • Multiple messages can be sent by adding messages into the msg list.
    • The same set of images, videos can be even sent to Multiple people by adding names into the name list.

    Input Parameters :

    name    : list, List of all contacts to which it should be sent in string format.
    msg      : str, Message to be sent.
    select : bool, Confirm if a particular command should be there on not. It has a Default Value true

    Code :

    var.send_text(name= ["",""], msg= "")
    

    Demo : To watch a quick demo, Click here


  • send_image

    • This method is used to automatically send image or video to the recipient.
    • Multiple Images, Videos can be sent by adding the file address with extension in the file_address list.
    • The same set of images, videos can be even sent to Multiple people by adding names into the name list.
    • Accepts all formats of image and videos.

    Input Parameters :

    name                : list, List of all contacts to which it should be sent in string format.
    files_address : list, Contains strings of address of files to be sent stored in list.
    select             : bool, Confirm if a particular command should be there on not. It has a Default Value true

    Code :

    var.send_image(name= ["", ""], files_address= ["",""], select: bool = True)
    

    Demo : To watch a quick demo, Click here


  • send_document

    • This method is used to automatically send files as documents to the recipient.
    • Multiple Documents can also be sent to the recipient by adding the files address in file_address list.
    • This same set of documents can be even sent to Multiple people by adding names into the name list.
    • Accepts all formats.

    Input Parameters :

    name                : list, List of all contacts to which document should be sent.
    files_address : list, Contains strings of address of files to be sent stored in list.
    select             : bool, Confirm if a particular command should be there on not. It has a Default Value of true

    Code :

    var.send_image(name= ["", ""], files_address= ["",""], select: bool = True)
    

    Demo : To watch a quick demo, Click here

  • send_audio

    • This method converts the given message into an audio recording and will send to the recipient.
    • The audio file can be sent to multiple recipients by adding recipients into name list.

    Input Parameters:

    name         : list, List of all contacts to which it should be sent in string format.
    msg           : str, Stores the message in string format.
    file_name : list, Name of the Audio File.
    file_dir   : str, name of file directory.
    select      : bool, Confirm if a particular command should be there on not. It has a Default Value of true

    Code :

    var.send_audio(name= ["", ""], files_address= ["",""])
    

    Demo : To watch a quick demo, Click here


  • create_group

    • This method is used to create a whatsapp group.
    • Using the contact names given in group_list and group name in group_name the whatsapp group is made.

    Input Parameters:

    group_list : list, Stores the list of names(str) to be added in group in a list.
    group_name : str, Name of the group.
    text_dir    : str, This is an alternate way of giving the list of group members and the group name by storing in a .txt file. Each line in the text file denotes one contact name and teh name at the end of text file denote Group name. Default filename is take as group_name.txt in the project directory

    Code :

    var.create_group(group_list= ["",""], group_name= "")
    

    Demo : To watch a quick demo, Click here


  • close_whatsapp

    • This method is used to close the running chrome driver.

    Input Parameters: None

    Code :

    var.close_whatsapp()
    

License

MIT

Contact

Made with <3 from unKNOWN-G

Project details


Download files

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

Source Distribution

autosel-0.0.6.tar.gz (15.4 kB view hashes)

Uploaded Source

Built Distribution

autosel-0.0.6-py3-none-any.whl (11.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page