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

• Package-name
• Main Features
• Table of Contents
• Prerequisites
• Installation
• What Classes are present in this Library?
• Email Class
  • Description
  • What Methods Do we have?
  • Importing and assigning Email class
  • Methods
• Whatsapp Class
  • Description
  • What Methods Do we have?
  • Importing and assigning Email class
  • Methods

---

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
• Whatsapp

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) gmails that arent created on this device to avoid security issues with google verification.

B. What Methods do we Offer?

• Email Class
  • send_mails

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 alternatingly 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 automatematically 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?

• Whatsapp Class
  • spam_bot
     
  • send_text
  • send_image
  • send_document
  • send_audio
  • create_group
     
  • close_whatsapp
     

C. Importing and assigning Email class

• Importing the Whatsapp Class

  from autosel import Whatsapp
  

• Assign Whatsapp Class to a variable

  To initialize the 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 Parameteres :

  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 Parameteres :

  name    : list, List of all contacts to which it should be send 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 Parameteres :

  name                : list, List of all contacts to which it should be send 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 Parameteres :

  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 a 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 send 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 denoteds 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